Whilst I don't think this settles the issue, in re: the diff headaches,
I've been fairly happy using:
git diff --color-words
Which is smart enough to deal with line-broken paragraphs in the way you'd
want it to. Am sure there's equivalents for other VCSes. Or there's GNU
"wdiff".
HP
On 18 June 2014 07:43, Dan Allen <[email protected]> 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.
>
> 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.
>
--
------------------------------
Harry J.W. Percival
------------------------------
Twitter: @hjwp
Mobile: +44 (0) 78877 02511
Skype: harry.percival
--
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.
