Re: markdown 2 man, was Re: Git Community Book

From: Abdelrazak Younes <younes@lyx.org>
Date: Aug 1, 2008, 07:11 UTC
Message-ID: <4892B714.8010401@lyx.org>
In-Reply-To: <7vvdylv9zq.fsf@gitster.siamese.dyndns.org>

Junio C Hamano wrote:

Show 12 quoted lines

> Abdelrazak Younes<younes@lyx.org>  writes:
>
>    
>> I just had a look at the user manual and, well unless you have a
>> special emacs mode or whatever that can automate the markup tag
>> insertion, I wonder how can anybody think that writing with this
>> markup language is easier than within LyX, really (genuine question,
>> not sarcasm).
>>      
>
> How greppable and "log -p"-able is the documentation written in LyX?
>

LyX format is plain text, loosely based on LateX. Here's attached a sample .lyx file FYI. We have one tag per line and a maximum of 80 char per line so that the format is easily parsable. Advanced users often use unix tools (grep, sed, etc) to modify the .lyx file manually.

>   * Where in the documentation do I have to change the description of
>     "--parents" option?
>

You mean in a text editor, not within LyX? Just look for the string :-)

>   * When did the description of "--cc" for diff families last changed, by
>     whom and why?
>

Ditto.

> Eas of doing these is mostly why we chose AsciiDoc to begin with.  Any
> alternative you are going to suggest should not make these two things
> impossible or very harder to do.
>

If you ignore the LyX tags, you can just do what you are used to do without problem using a plain text editor. If you want to do something more complicated stuff like choosing a different environment or creating a nested enumerate list, it is easier to do that within LyX.

Abdel.