Re: @part command and docbook

[Dumas Patrice]

On Tue, May 06, 2014 at 09:59:20AM +0300, Aharon Robbins wrote:
> Hi Karl and Patrice.
> 
> > How about:
> >
> > @part Part Title
> > @docbook
> > <partintro>intro to part blah blah</partintro>
> > @end docbook
> >
> > Does that work?  That seems to me to best reflect the reality of the
> > situation, which is that "partintro" text is a Docbook feature, not
> > supported in Texinfo.
> 
> It probably works, but it means I have to write all the
> text in docbook instead of in Texinfo.  I tried various bits
> with @inlinefmt but then the <partintro> got wrapped inside
> <para> tags and that was totally wrong.

Doesn't the following work:

@part A nice part

@ifdocbook
@docbook
<partintro>
@end docbook

The part is very nice.

@docbook
</partintro>
@end docbook
@end ifdocbook

> Is it reasonable to require that text after @part and before @chapter be
> wrapped in @ifdocbook and then makeinfo can supply the <partintro> tags?

I think that there should be no situation in which we document that @if*
commands should be used to use a Texinfo feature.  There is only one
such occurrence for now, for the titlepage, and I think that it should
not be that way.

> 1. Require and document that @part and following text be wrapped
> in @ifnotinfo.

Same as above, I don't think that we should ever propose to the user in
the Texinfo manual format conditionals for standard Texinfo language
features.

> 4. makeinfo --docbook supplies <partintro> tags.

That being said, I still think that it could make sense to supply
<partintro> tags to get valid DocBook, even if the Texinfo is invalid,
but I leave that decision to Karl.

-- 
Pat