Item lists bulletting (was: Re: RFC: Better formatting for long descriptions)
Andreas Tille a écrit : I have not found any recommendation regarding this at the SRP Wiki page [1]. I vaguely remember that this Smith project was initially driven by a French guy who might try to push a French habit into the English world. ;-) Of course. Because, contrary to the world of English language, we *do* have written rules for such cases. From the Lexique des règles typographiques en usage à l'Imprimerie Nationale (which is the reference for all typographic conventions for the French languagethe reference book of all French TeXnicians) : Les énumérations - elles sont introduites par un deux-points ; - les énumérations de premier rang sont introduites par un tiret et se terminent par un point-virgule, sauf la dernière par un point final ; - les énumérations de second rang sont introduites par un tiret décalé et se terminent par une virgule. Which (badly) translates to: Itemizations: - they're introduced by a colon; - first degree itemizations are preceeded by a dash and end with a semi-colon, except the last one that ends up with a sentence dot; - second degree itemizations are preceeded by a tabbed dash and end up with a comma. I have never been able to find any such solid reference for English. There is probably something in the Chicago Manual of Style, that's generally accepted as the Right Reference for en_US. Maybe more input from our experts on debian-l10n-english? -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Re: Item lists bulletting (was: Re: RFC: Better formatting for long descriptions)
to, 2009-04-16 kello 08:42 +0200, Christian Perrier kirjoitti: I have never been able to find any such solid reference for English. There is probably something in the Chicago Manual of Style, that's generally accepted as the Right Reference for en_US. Maybe more input from our experts on debian-l10n-english? I'm not an expert, but I have the 14th edition of the CMS. It says both bullets and dashes are acceptable (8.77, page 314, for reference). (I am not expressing an opinion for or against the normalization of long description markup.) -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Re: Item lists bulletting (was: Re: RFC: Better formatting for long descriptions)
Quoting Lars Wirzenius (l...@liw.fi): to, 2009-04-16 kello 08:42 +0200, Christian Perrier kirjoitti: I have never been able to find any such solid reference for English. There is probably something in the Chicago Manual of Style, that's generally accepted as the Right Reference for en_US. Maybe more input from our experts on debian-l10n-english? I'm not an expert, but I have the 14th edition of the CMS. It says both bullets and dashes are acceptable (8.77, page 314, for reference). Well, based on that discussion, these facts and the current practice, I think that, in Smith reviews, we will, from now, recommend the use of asterisks for 1st level items in item lists, in package descriptions and debconf templates (these are the texts we review). Please note that this is not *enforcing* things on maintainers. All Smith reviews are suggestions made to maintainers and they are associated to the whole discussion/review. When maintainers insist on some practice (or even spelling|wording) we always follow their advice at the endeven for mainainers who insist on using first person sentences (hint hint). The same will happen for item lists. signature.asc Description: Digital signature
