Re: Org mode and Emacs (was: Convert README.org to plain text README while installing package)

[Tim Cross]

Ihor Radchenko <yantar92@gmail.com> writes:

> Tim Cross <theophilusx@gmail.com> writes:
>
>> There are many ways org mode can be improved. Current work to clarify
>> and refine the syntax, provide a solid and efficient parser, improved
>> font-locking and formatting and more consistent and rich API for both
>> extensions and new export backends are far more critical than adding
>> additional markup/markdown syntax to enable org mode to replace texinfo.
>> IMO such changes are not only misguided, they have the real potential to
>> adversely impact org by making things more complicated and harder to
>> maintain, destroying the advantage of a very small and easy to use
>> markup and moving the focus towards becoming an authoring tool rather
>> than a personal data organisation aid.
>
> Tim, I afraid that we a slipping to overgeneralisation again.
> We may or may not need to make changes to Org syntax for the purpose of
> writing documentation using Org.
>
> Can someone please prepare a small example texi file containing examples
> of various texi features that are commonly needed and possibly also
> demonstrating some concrete instances of problems that exist in texinfo?
>
> If we have such an example and know the expected outputs, someone can
> then create an equivalent Org file. Then, the discussion will hopefuly
> become more constructive.
>

Well, I think Richard was pretty clear when he asked for the additional
semantic tags listed in the Indicating Definitions, Commands & etc
section of the texinfo manual (6.1 in my copy). Looking at just that
section and it is clear current org markup syntax can handle less than
half. Some of those not handled are the types of semantic elements you
would tend to encounter in software manuals and that is just one section. 

However, I think I've made my position clear and have little more to
add, so I will bow out of any further discussion.