Yet another reason why I'm strongly opposed to arbitrary line wrapping. It's just a bad practice, even if the syntax was smart enough to know what to do.
There are two sane strategies, IMO: . Break at the end of a sentence and, optionally, strong independent clauses . Break only at the end of a paragraph Neither of those are arbitrary. There may even be other strategies you can define with logical breaks. It's the arbitrary hard breaks that are problematic for writing, esp when the writing is collaborative. There are numerous reasons for using logical breaks, but there's one more important than all the rest. If you change a word early in a paragraph, then reformat that paragraph on a fixed column width, it appears in the diff like you changed every line in the paragraph when you only changed one word. You are touching lines you did not edit. This would be considered an act of treachery in programming. It should be the same with writing. -Dan On Thu, Mar 27, 2014 at 7:03 PM, Lex Trotman <[email protected]> wrote: > On 28 March 2014 05:22, mattn <[email protected]> wrote: > > The documentation gives this example of how to write bibliography > entries: > > > > [bibliography] > > .Optional list title > > - [[[taoup]]] Eric Steven Raymond. 'The Art of UNIX > > Programming'. Addison-Wesley. ISBN 0-13-142901-9. > > - [[[walsh-muellner]]] Norman Walsh & Leonard Muellner. > > 'DocBook - The Definitive Guide'. O'Reilly & Associates. > > 1999. ISBN 1-56592-580-7. > > > > > > But when I try that and render the document, I get a mistake on the > "1999" - > > it is seen as a numbered list and is changed to a "1". > > > > So either AsciiDoc should not do that, or the example should not show > it. I > > think the latter would be best. > > Indeed the example should have left the 1990 on the previous line I > would think. Can you make a pull request to change the document (if > it works that is). > > Cheers > Lex > > > > > -- > > You received this message because you are subscribed to the Google Groups > > "asciidoc" group. > > To unsubscribe from this group and stop receiving emails from it, send an > > email to [email protected]. > > To post to this group, send email to [email protected]. > > Visit this group at http://groups.google.com/group/asciidoc. > > For more options, visit https://groups.google.com/d/optout. > > -- > You received this message because you are subscribed to the Google Groups > "asciidoc" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/asciidoc. > For more options, visit https://groups.google.com/d/optout. > -- Dan Allen | http://google.com/profiles/dan.j.allen -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
