Re: Text not showing up

Sent with Proton Mail secure email.

On Sunday, May 18th, 2025 at 12:06 AM, Heime <[email protected]> wrote:

> 
> 
> 
> 
> 
> Sent with Proton Mail secure email.
> 
> 
> On Saturday, May 17th, 2025 at 9:53 PM, Patrice Dumas [email protected] wrote:
> 
> > On Sat, May 17, 2025 at 02:15:22AM +0000, Heime via Users list for the Texinfo documentation system wrote:
> > 
> > > Have made an info file but not sure whether it has been made correctly.
> > > I do not get the text I have written.
> > 
> > There are no @node in your manual. If you convert to Info format,
> > by calling for instance
> > 
> > texi2any icord.texi
> > 
> > you will get a warning:
> > icord.texi: warning: document without nodes
> > 
> > and you will get an output Info file that shows nothing upon reading in
> > an Info reader, as there are no nodes. If you convert to plaintext,
> > PDF, or HTML you get something in output, though, for HTML, not split at
> > nodes, but everything on one HTML page.
> > 
> > Another issue is that there is no @top command (nor @node Top).
> > 
> > If you do not want to add nodes manually, you can have texi2any insert them
> > automatically, but you will still need a @top to have a @node Top
> > created automatically such that the Info reader can find the first node.
> > 
> > texi2any -c TREE_TRANSFORMATIONS=insert_nodes_for_sectioning_commands icord.texi
> > 
> > Note that you can still starts with a given node, but it is not the
> > usual way to use the Info format.
> > 
> > info ./icord.info -n Introduction
> > 
> > --
> > Pat
> 

Read through "3.5 The @top Sectioning Command".  Which uses @ifnottex.
Is this always the correct way?  Do I have to use anything else?



@ifnottex
@node Top
@top your-manual-title

very-high-level-summary
@end ifnottex