sdtweb

sdtweb#

Purpose

SDT file navigation function.

Description

This function allows opening the SDT documentation, opening classical file types outside Matlab, and source code navigation.

OpenFileAtTag#

When not called by a command starting with _, sdtweb opens a file.

The documentation can be displayed at two locations :

  • In the MATLAB help browser : define this location as default with sdtdef('browser-SetPref','') or sdtdef('browser-SetPref','-helpbrowser')
  • In the MATLAB web browser : : define this location as default with sdtdef('browser-SetPref','hack')

(Note that without the -SetPref, the displayed location is only modified for the current session, which is useful to temporarily switch from one display to the other.)

Their is a MATLAB bug when displayed in the help browser : links to locations on a page sometimes do not work properly, so that using the web browser is more convenient for now. It is recommended to use the help browser only to do a research in the documentation or if the table of content is really needed.

The main cases are

 sdtweb feutil             % Html documentation of feutil
 sdtweb feutil#Renumber    % at a tag in the HTML file
 sdtweb feutil#Renumber -browser  % same but in external browser
 sdtweb feutil('renumber') % open .m file at tag 'renumber'
 sdtweb source.c#tag       % source.c file at tag 
 sdtweb file.doc           % opens word for a given file.doc

sdtweb('_path') lists the help search path. sdtweb('_pathReset') redefines preferences.

Utils#

sdtweb('_link','callback','comment') creates a clickable link.

sdtweb('_links','callback','comment') creates a clickable link showing just the comment.

sdtweb('_wd',wd0,wd1) recursively searches for a subdirectory of wd0 named wd1. Command option -reset regenerates the underlying directory scan.

sdtweb('_fname',fname,wd0) recursively searches for a file named fname in wd0 or any of its subdirectories, or the current directory.

sdtweb('_find','base_wd','filename') searches for a file within the base working directory.

sdtweb('_tracker','support',979) opens a tracker on the support web site.

sdtweb('_BP','FunctionName','Tag') Find Tag in FunctionName (result of sdtweb FunctionName Tag and set breakup here for debug.

sdtweb('_TexFromHTML','HmtlFileName') Find .tex and line source corresponding to the HmtlFileName.html help file.

sdtweb('_TabButName',cf,'TabName') Display button names in the console, ordered in a cell array the same way than in the Tab.

_taglist#

This commands opens the TagList figure (tree view of your file providing links for source code navigation)

  sdtweb _taglist   % Open taglist of current editor file (if not docked)
  sdtweb _taglist feutil % Open taglist of feutil

Accepted command options are

  • -sortABC will display the navigation tree alphabetically sorted.
  • -levelval in combination with sortABC perform the alphabetical sorting up to level val.

The coding styles convention associated to the TagList parsing are detailed in section 7.17 (sdtweb('syntax')).