Mercurial > hg > soundsoftware-site
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 |