Since my patch to add a reference to a CSS file in default.dsl has not yet been applied, I'm submitting this patch which hopefully will be less controversial and is useful in its own right anyway. What I did is generate the doc and then remove the 'systemitem' and 'empty-sosofo' parts of default.dsl. I generated the doc again and analyzed the differences. The only difference is in the debugger.html file and comes about because we do this: on <systemitem class="systemname">ftp.winsite.com</systemitem> Now there's really no reason why we should put the above in debugger.sgml rather than simply link to the winsite's web page. on <ulink url="http://www.winsite.com/";>http://www.winsite.com</> So I modified debugger.sgml and simplified default.dsl. Changelog: * documentation/debugger.sgml, documentation/default.dsl Removed reference to 'systemname' and added a link to winsite in debugger.sgml Remove cruft from default.dsl. Add comments explaining what our other settings do Index: documentation/debugger.sgml =================================================================== RCS file: /home/wine/wine/documentation/debugger.sgml,v retrieving revision 1.24 diff -u -r1.24 debugger.sgml --- documentation/debugger.sgml 21 Jul 2003 22:42:50 -0000 1.24 +++ documentation/debugger.sgml 12 Sep 2003 10:36:39 -0000 @@ -490,15 +490,15 @@ <para> The best, freely available, disassembler for Win16 programs is <application>Windows Codeback</application>, archive name - <filename>wcbxxx.zip</filename>, which usually can be found in - the <filename>Cica-Mirror</filename> subdirectory on the Wine - ftp sites. (See <filename>ANNOUNCE</filename>). + <filename>wcbxxx.zip</> (e.g. <filename>wcb105a.zip</>), which + usually can be found in the <filename>Cica-Mirror</filename> + subdirectory on the Wine ftp sites. (See <filename>ANNOUNCE</>). </para> <para> Disassembling win32 programs is possible using - <application>Windows Disassembler 32</application>, archive name - something like <filename>w32dsm87.zip</filename> (or similar) - on <systemitem class="systemname">ftp.winsite.com</systemitem> + <application>Windows Disassembler 32</>. Look for + a file called <filename>w32dsm87.zip</> (or similar) + on <ulink url="http://www.winsite.com/";>http://www.winsite.com</> and mirrors. The shareware version does not allow saving of disassembly listings. You can also use the newer (and in the full version better) <application>Interactive Index: documentation/default.dsl =================================================================== RCS file: /home/wine/wine/documentation/default.dsl,v retrieving revision 1.1 diff -u -r1.1 default.dsl --- documentation/default.dsl 13 Dec 2000 21:52:37 -0000 1.1 +++ documentation/default.dsl 12 Sep 2003 10:36:39 -0000 @@ -7,15 +7,21 @@ <style-specification id="html" use="docbook"> <style-specification-body> +; Use the section id as the filename rather than +; cryptic filenames like x1547.html (define %use-id-as-filename% #t) -(define %html-ext% ".html") -(define %html-header-tags% '()) + +; Repeat the section number in each section to make it easier +; when browsing the doc +(define %section-autolabel% #t) ;;(define %stylesheet% "../../winehq.css") ;;(define %stylesheet-type% "text/css") +; All that remains is to hard-code various aspects of the look and feel +; (colors, italics, etc.) + (define %shade-verbatim% #t) -(define %section-autolabel% #t) ;; Customize the body tag color attributes (define %body-attr% @@ -36,33 +41,6 @@ ;(list "BGCOLOR" "#FFD39B") ; burlywood1 (tan) ;(list "BGCOLOR" "#FFE7BA") ; wheat1 (light tan) (list "WIDTH" ($table-width$)))) - -;; Customize systemitem element to have different formatting, according -;; to which class attribute it contains. -(element systemitem - (let ((class (attribute-string (normalize "class")))) - (cond - ((equal? class (normalize "systemname")) ($italic-mono-seq$)) - ((equal? class (normalize "constant")) ($mono-seq$)) - (else ($charseq$))))) - -;; Okay, this is a little tricky. By default, it appears that setinfo is -;; completely turned off (with empty-sosofo). The setinfo title is extracted -;; through some other means, so we can ignore it when we process the setinfo -;; below. - -;; Process setinfo element -(element setinfo (process-children)) -;; Ignore title element -- otherwise it'll appear alongside the releaseinfo -;; element. If we add any other elements to setinfo, we'll have to blank them -;; out here, also. -(element (setinfo title) - (empty-sosofo)) -;; Enclose releaseinfo element in italics -(element (setinfo releaseinfo) -; (make element gi: "i" -; (process-children))) - (process-children)) </style-specification-body> </style-specification> -- Francois Gouget fgouget@free.fr http://fgouget.free.fr/ Any sufficiently advanced Operating System is indistinguishable from Linux
