diff --git a/documentation/documentation.sgml b/documentation/documentation.sgml index 096f87c7ea3..64c947ebb39 100644 --- a/documentation/documentation.sgml +++ b/documentation/documentation.sgml @@ -1,10 +1,6 @@ Documenting Wine - - Written by &name-jon-griffiths; &email-jon-griffiths; - - This chapter describes how you can help improve Wines documentation. @@ -91,10 +87,6 @@ Writing Wine API Documentation - - Written by &name-jon-griffiths; &email-jon-griffiths; - - Introduction to API Documentation @@ -611,13 +603,6 @@ BOOL WINAPI PathRelativePathToA( The Wine DocBook System - - Written by &name-john-sheets; &email-john-sheets; - - - Modified by &name-tony-lambregts; &email-tony-lambregts; Nov. 2002 - - Writing Documentation with DocBook @@ -684,11 +669,11 @@ BOOL WINAPI PathRelativePathToA( - run ./make_winehq + run make html - View wine-doc/index.html in your favorite browser + View wine-user.html, wine-devel.html, etc in your favorite browser @@ -823,15 +808,6 @@ BOOL WINAPI PathRelativePathToA( - - SGML on Other Distributions - - Fix me - - List package names and install locations... - - - Terminology @@ -1118,12 +1094,11 @@ BOOL WINAPI PathRelativePathToA( There are often many correct ways to mark up a given piece of text, and you may have to make guesses about which tag to use. Sometimes you'll have to make compromises. - However, remember that it is possible to further customize the output of - the SGML processors. If you don't like the way a certain - tag looks in HTML, that doesn't mean you should choose a - different tag based on its output formatting. The - processing stylesheets can be altered to fix the + However, remember that it is possible to further customize + the output of the SGML processors. If you don't like the + way a certain tag looks in HTML, that doesn't mean you + should choose a different tag based on its output formatting. + The processing stylesheets can be altered to fix the formatting of that same tag everywhere in the document (not just in the place you're working on). For example, if you're frustrated that the - FIXME - This section needs more info about... + EXAMPLE + This is an example note... ]]> The results will look something like this: - FIXME - This section needs more info about... + EXAMPLE + This is an example note... @@ -1700,12 +1675,12 @@ BOOL WINAPI PathRelativePathToA( - + @@ -1723,19 +1698,19 @@ BOOL WINAPI PathRelativePathToA( popular Linux distributions. - + - + @@ -1749,13 +1724,13 @@ BOOL WINAPI PathRelativePathToA( editors exist for it; however, until recently open source SGML editors have been scarce. - + The most commonly used open source SGML editor is Emacs, with the PSGML mode, or extension. @@ -1778,7 +1753,7 @@ BOOL WINAPI PathRelativePathToA( - +