I will (time and laziness permitting, so don't hold your breath too much) try and reformat the XML documentation to stick to some common guidelines. Problem is setting those guidelines. My propositions are: <sect1>: before each sect1 there's a line of <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> with two blank lines before and two after. <sect2>: before each sect2 there's <!-- ********** --> with blank line before and after. <sect3>: two blank lines before. <title>: Each title goes just below it's corresponding tag (<sect?>, <formalpara> or whatever), and stays in one line (this can mean the line can get very long). <para> start-tag and end-tags in separate lines, don't indent the content (more than <para> itself is indented, that is). Things like tables, lists etc: start and end tags in separate lines, increase indent by 2 spaces, item start and end tags as well in separate lines (but when whole item contains a single <para> or something like that than this <para> goes with element start tag. All 'small' tags (title, ulink, link, application, keycap, etc.) fit in a single line. Line limit of 80 characters (With exception of small tags above). <screen>: either in single line, like small tags or like this: <screen> text (with no indent) \ maybe continuation of a longer command (indented)<!-- --><screen> with <screen> and --> beginning at the current indentation level. Any comments? Objections? Better formats? Clarifications? I'm not very much attached to this, we just have to start at something and this seems to be mostly how the doc's are formated now. Torinthiel -- Waclaw "Torinthiel" Schiller GG#: 3073512 torinthiel(at)megapolis(dot)pl gpg: 0906A2CE fpr: EE3E DFB4 C4D6 E22E 8999 D714 7CEB CDDC 0906 A2CE "No classmates may be used during this examination"
On Wed, Nov 15, 2006 at 11:33:01PM +0100, Torinthiel wrote:
I will (time and laziness permitting, so don't hold your breath too much) try and reformat the XML documentation to stick to some common guidelines. Problem is setting those guidelines.
My propositions are:
<sect1>: before each sect1 there's a line of <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> with two blank lines before and two after.
<sect2>: before each sect2 there's <!-- ********** --> with blank line before and after.
I think just a few blank lines, maybe 3, will do the trick as well, but I'm not very particular about this.
<sect3>: two blank lines before.
<title>: Each title goes just below it's corresponding tag (<sect?>, <formalpara> or whatever), and stays in one line (this can mean the line can get very long).
Nah, I'd say the lines can be broken.
<para> start-tag and end-tags in separate lines, don't indent the content (more than <para> itself is indented, that is).
Fine with me.
Things like tables, lists etc: start and end tags in separate lines, increase indent by 2 spaces, item start and end tags as well in separate lines (but when whole item contains a single <para> or something like that than this <para> goes with element start tag.
Fine with me.
All 'small' tags (title, ulink, link, application, keycap, etc.) fit in a single line.
Line limit of 80 characters (With exception of small tags above).
Fine with me.
<screen>: either in single line, like small tags or like this: <screen> text (with no indent) \ maybe continuation of a longer command (indented)<!-- --><screen>
with <screen> and --> beginning at the current indentation level.
Fine with me.
Any comments? Objections? Better formats? Clarifications? I'm not very much attached to this, we just have to start at something and this seems to be mostly how the doc's are formated now.
Such a reformatting would be welcome. Go right ahead. Diego
On Sat, Dec 02, 2006 at 10:17:58PM +0100, Diego Biurrun wrote:
On Wed, Nov 15, 2006 at 11:33:01PM +0100, Torinthiel wrote:
<sect1>: before each sect1 there's a line of <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> with two blank lines before and two after.
<sect2>: before each sect2 there's <!-- ********** --> with blank line before and after.
I think just a few blank lines, maybe 3, will do the trick as well, but I'm not very particular about this.
Neither am I, but I did it this way. If we later change mind it'll be easier to sed.
<title>: Each title goes just below it's corresponding tag (<sect?>, <formalpara> or whatever), and stays in one line (this can mean the line can get very long).
Nah, I'd say the lines can be broken. OK
Such a reformatting would be welcome. Go right ahead.
Just noticed this mail by luck ;) Done, I hope I haven't screwed up too much. Torinthiel -- Waclaw "Torinthiel" Schiller GG#: 3073512 torinthiel(at)megapolis(dot)pl gpg: 0906A2CE fpr: EE3E DFB4 C4D6 E22E 8999 D714 7CEB CDDC 0906 A2CE "No classmates may be used during this examination"
participants (2)
-
Diego Biurrun -
Torinthiel