comparison extra/soundsoftware/matlab-docs.conf @ 524:1248a47e81b3 feature_36

Merge from branch "luisf"
author luisf <luis.figueira@eecs.qmul.ac.uk>
date Mon, 25 Jul 2011 14:39:38 +0100
parents e7ba81c8dc5a
children
comparison
equal deleted inserted replaced
519:3be6bc3c2a17 524:1248a47e81b3
1 # configuration file for generation of html-docu from m-files
2 #
3 # Author: Hartmut Pohlheim
4 # History: 05.11.2000 file created (parameters for mtree2html2001)
5 #
6 # The following options/variables must be changed/adapted:
7 # dirmfiles
8 # dirhtml
9 # csslink
10 # texttitleframelayout
11 # texttitlefiles
12 #
13 # The following options/variables should be adapted:
14 # authorfile
15 # filenametopframe
16 # codeheadmeta
17
18 #========================================================================
19 # Variables (possible keywords: set)
20 # to use the built-in settings, comment the line using # in first column
21 #========================================================================
22
23 #------------------------------------------------------------------------
24 # dirmfiles: name of directory containing Matlab m-files
25 # dirhtml: name of directory to place the html-files into
26 # exthtml: extension used for the html files (.html or .htm)
27 # don't forget the point in front of the extension
28 #------------------------------------------------------------------------
29 set dirmfiles = .
30 set dirhtml = doc-output
31 set exthtml = .html
32
33 #------------------------------------------------------------------------
34 # authorfile: name of file containing info about author (in html)
35 # if defined, this text is included at the bottom of the
36 # html files
37 #------------------------------------------------------------------------
38 set authorfile = matlab-docs-credit.html
39
40 #------------------------------------------------------------------------
41 # csslink: text for linking to css file (style sheets)
42 # the text defined here is directly included into the head
43 # of the html file
44 #------------------------------------------------------------------------
45 #set csslink = <link rel=stylesheet type="text/css" href="CSSFILENAME.css" />
46
47 #------------------------------------------------------------------------
48 # links2filescase: this is a bit difficult
49 # Matlab is case sensitive on UNIX, but case insensitive
50 # on Windows. Under UNIX Matlab function calls work
51 # only, when the case of file name and function call are
52 # identical, under Windows you can do what you want.
53 # This scripts help you, to keep an exact case in your
54 # project.
55 # exact - internal links are only generated, when case of file
56 # name and in source code are identical
57 # all - case doesn't matter
58 # exactupper - same as exact, additionally links are also vreated to
59 # all upper case function names in source code (often
60 # used by Mathworks)
61 # exactvery - same as exact, additionally info about not matching
62 # case is written to screen (stdout), this can be very
63 # helpful in cleaning up the case in a project
64 #------------------------------------------------------------------------
65 set links2filescase = all
66
67 #------------------------------------------------------------------------
68 # texttitleframelayout: text of title for frame layout file (whole docu)
69 #------------------------------------------------------------------------
70 set texttitleframelayout = MATLAB Function Documentation
71
72 #------------------------------------------------------------------------
73 # texttitle/headerindexalldirs: text of title and header for directory index
74 #------------------------------------------------------------------------
75 set texttitleindexalldirs = Index of Directories
76 set textheaderindexalldirs = Index of Directories
77
78 #------------------------------------------------------------------------
79 # texttitle/headerindex: text of title and header for index file
80 #------------------------------------------------------------------------
81 set texttitleindex = A-Z Index of Functions
82 set textheaderindex = A-Z Index of Functions
83
84 #------------------------------------------------------------------------
85 # texttitle/headerfiles: text of title and header for files
86 # name of file will be added at the end
87 #------------------------------------------------------------------------
88 set texttitlefiles = Function
89 set textheaderfiles = Documentation of
90
91 #------------------------------------------------------------------------
92 # frames: whether to use frames in layout (yes or no)
93 #------------------------------------------------------------------------
94 set frames = no
95
96 #------------------------------------------------------------------------
97 # filenametopframe: name of file including frame layout (highest level file)
98 # [default: index]
99 #------------------------------------------------------------------------
100 set filenametopframe = index
101
102 #------------------------------------------------------------------------
103 # textjumpindexglobal: text displayed for jump to index of all files
104 # (global)
105 # textjumpindexlocal: text displayed for jump to index of files in actual
106 # directory (local)
107 #------------------------------------------------------------------------
108 set textjumpindexglobal = <b>Index of</b> all files:
109 set textjumpindexlocal = this subdirectory only:
110
111 #------------------------------------------------------------------------
112 # includesource: include source of m-files in documentation [YES|no]
113 #------------------------------------------------------------------------
114 set includesource = yes
115
116 #------------------------------------------------------------------------
117 # usecontentsm: use contents.m files as well for structured
118 # (hopefully) index [YES|no]
119 #------------------------------------------------------------------------
120 set usecontentsm = no
121
122 #------------------------------------------------------------------------
123 # includesource: write/update contents.m files [yes|NO]
124 #------------------------------------------------------------------------
125 set writecontentsm = no
126
127 #------------------------------------------------------------------------
128 # processtree: parse whole directory tree recursively [YES|no]
129 #------------------------------------------------------------------------
130 set processtree = yes
131
132 #------------------------------------------------------------------------
133 # producetree: produce tree for html-files in same structure than
134 # tree of m-files [yes|NO]
135 # if no, all files are saved in the same directory, often
136 # easier for outside linking to files
137 #------------------------------------------------------------------------
138 set producetree = yes
139
140 #------------------------------------------------------------------------
141 # codebodyindex/files: HTML-code for adding to BODY tag
142 # can be used for defining colors and
143 # backgroundimages of the files
144 # No longer recommended, use the css file
145 #------------------------------------------------------------------------
146 set codebodyindex =
147 set codebodyfiles =
148
149 #------------------------------------------------------------------------
150 # codeheadmeta: HTML-code added in HEAD area, use for supplying META info
151 #------------------------------------------------------------------------
152 set codeheadmeta =
153
154 #------------------------------------------------------------------------
155 # codehr: HTML-code used to define a <HR>, do what you want
156 #------------------------------------------------------------------------
157 set codehr = <hr>
158
159 #------------------------------------------------------------------------
160 # codeheader: HTML-code added to <H*> tags, use for centering header text
161 # or changing the colour/size/font of the header text
162 #------------------------------------------------------------------------
163 set codeheader =
164
165
166 # End of parameter file