On Wednesday, 18 June 2014 08:43:58 UTC+2, Dan Allen wrote: > > 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. >
I would disagree. in my experience the annoying thing about soft line wrapping is that if you do minor edits at different places within a paragraph (constituting a single line of the document in this case) one really needs smart diff tools to come to terms with it. I'm quite happy with ignoring white space changes (including line breaks) in my diffs of text documents so the reformatting issue you mention is not causing real problems for the diff. overall I'm therefore more happy with maintaining a "sane" line length in the (asciidoc or latex) source files so that the source files have an appearance with does not change if I resize the teminal/vi window. at the very least I would maintain that we don't have a "one size fits all" or clearcut "wrong vs. right" situation here. If soft line wrapping suits you best, fine, but it's different for me and not the law ;-) j. > > 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] > <javascript:>> wrote: > >> On 28 March 2014 05:22, mattn <[email protected] <javascript:>> 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] <javascript:>. >> > To post to this group, send email to [email protected] >> <javascript:>. >> > 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] <javascript:>. >> To post to this group, send email to [email protected] >> <javascript:>. >> 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.
