Re: Gnus-FAQ: xml to texi with Scheme prog

[sigurd@12move.de (Karl Pflästerer)]

On 20 Mrz 2005, reinersteib+gmane@imap.cc wrote:

>
> On Tue, Mar 15 2005, Karl Pflästerer wrote:
> [ Scheme program to transform `gnus-faq.xml' to `gnus-faq.texi' ]
>
> I have installed the files `xml2texi.scm' and `xml2texi.sh' in texi/
> in the v5-10 branch.  I did some modifications on `xml2texi.scm' and
> `gnus-faq.xml' to improve the printed output.
>
> Some questions and remarks (not all related to xml2texi):
>
> - `+section-comments-alist+' should be put into `gnus-faq.xml'.

As I wrote in pm I think the best place for that information would be
attributes to the section titles.  If that would be changed I could
change also the Scheme program. 

> -  The "Changes" section should not be present in the texi version.

I'll look for that.


> -  Is there a possibility to add @cindex entries in `gnus-faq.xml'?

XML knows some sort of index commands; so if they were present in the
XML source they could be included in the generated texi file.  Maybe
this could be done together with the solution for the
+section-comments-alist+'.

> - <userinput>...</userinput> is translated to @samp{...}.  It would be
>   nice to have @kbd{T n}, @code{tar xvzf ...}, @file{~/.gnus.el}, etc.

I used the same format I found in the texi file.  The problem I see
here: how should the translating program know when to use e.g. @kbd and
when @code since both forms are included with the same tag: `userinput'

Maybe we find together a solution.

> - Currently texi/gnus-faq.texi has the following arch tag:
>
> ,----
>| @ignore
>|    arch-tag: 64dc5692-edb4-4848-a965-7aa0181acbb8
>| @end ignore
> `----
>
> How to deal with this?  Should we add something like...
>
>   (insert "@ignore\n   "
>           "arch-tag: "
> 	  "64dc5692-edb4-4848-a965-7aa0181acbb8"
>           "\n@end ignore")
>
> ... in `main' in `xml2texi.scm'?  I guess this would make sure that it
> is not confused with the arch tag of the file `xml2texi.scm'.  Miles?
> (I will not install the re-created `gnus-faq.texi' before this is
> clarified.)
>
> Bye, Reiner.

   KP