Hi Vincent,
Thanks for the patch! And sorry about not responding sooner.
I think your patch is small / mechanical enough to not need a copyright
assignment, but I am still interested to know if you have signed papers
w/ the FSF for changes to Emacs.
Thanks!
Eric
On 09/09/2012 02:16 AM, Vincent Belaïche wrote:
> Hello,
>
> I got the latest sources on Bazaar, and did some patch on the
> documentation for it to compile w/o error or warnings with texi2any.
>
> Herein attached is the patch file and a change log.
>
> However, there remained some issue (here is the log):
>
> lang-support-guide.texi:1059: warning: Node `Parser Backend Support' is next for `Grammar Programming Environment' in menu but not in sectioning
> lang-support-guide.texi:1114: warning: Node `Grammar Programming Environment' is prev for `Parser Backend Support' in menu but not in sectioning
> lang-support-guide.texi:1114: warning: Node up `Parser Backend Support' in menu `Writing Parsers' and in sectioning `Parsing a language file' differ
> lang-support-guide.texi:1071: Node `Parsing a language file' lacks menu item for `Parser Backend Support' despite being its Up target
> make[2]: *** [semantic-langdev.info] Error 1
> make[2]: Leaving directory `/c/Programme/GNU/installation/cedet-install/cedet/doc/texi/semantic'
> make[1]: *** [semantic-doc] Error 2
> make[1]: Leaving directory `/c/Programme/GNU/installation/cedet-install/cedet/doc/texi'
> make: *** [info] Error 2
>
> The problem is that you have some node tree like this:
>
> +---------------+ +----------------+
> |Writing Parsers|-----+---->|External Parsers|
> +---------------+ | +----------------+
> |
> | +-------------------------------+
> +---->|Grammar Programming Environment|
> | +-------------------------------+
> |
> | +----------------------+
> +---->|Parser Backend Support|
> +----------------------+
>
> But the sectionning structure is like that:
>
> +---------------+ +----------------+
> |Writing Parsers|-----+---->|External Parsers|
> +---------------+ | +----------------+
> |
> | +-------------------------------+
> +---->|Grammar Programming Environment|
> +-------------------------------+
>
> +-----------------------+ +----------------------+
> |Parsing a language file|--->|Parser Backend Support|
> +-----------------------+ +----------------------+
>
> That causes some warnings for the inconsistencies of either structures
> with each other, but the real issue is that you as you use automatic
> node linking based on sectionning `Parser Backend Support' is detected
> as being a subnode of `Parsing a language file' based on sectionning,
> but the @menu does not say that.
>
> So there are two ways to solve the problem --- and that is why I did not
> produce any patch:
>
> 1) either you want to keep the sectionning structure and the node
> strucutre as they are, so in the @node command for `Parser Backend
> Support' you indicate explcitely that the upnode is `Writing Parsers'
>
> 2) or you change this structure for consistency, and so you demote
> chapter `Parsing a language file' and sub section, and set menu of
> `Writing Parsers' to replace `Parser Backend Support' by `Parsing a
> language file'.
>
> VBR,
> Vincent.
>
> PS: Thanks to Patrice Dumas for his kind support.
>
>
>
>
> ------------------------------------------------------------------------------
> Live Security Virtual Conference
> Exclusive live event will cover all the ways today's security and
> threat landscape has changed and how IT managers can respond. Discussions
> will include endpoint security, mobile security and the latest in malware
> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
>
>
>
> _______________________________________________
> cedet-semantic mailing list
> cedet-semantic@...
> https://lists.sourceforge.net/lists/listinfo/cedet-semantic
|