Re: Text not showing up

Heime via Users list for the Texinfo documentation system <[email protected]> Sat, 17 May 2025 12:36:43 +0000
Newsgroups gmane.comp.tex.texinfo.general
Message-ID <s3gInBSi7kbwctDpbZppQf9Wzg_Aio_j2rgERxIqFwAEahVOh5TDLgAzWsRYaqzHYKTMT6rT2ZOz-5Q9G0YFp5J6d6hBlmq96J7IEHxg6wo=@protonmail.com>




Sent with Proton Mail secure email.

On Sunday, May 18th, 2025 at 12:17 AM, Patrice Dumas <[email protected]> wrote:

> On Sat, May 17, 2025 at 12:11:19PM +0000, Heime wrote:
> 
> > Read through "3.5 The @top Sectioning Command". Which uses @ifnottex.
> > Is this always the correct way? Do I have to use anything else?
> 
> 
> No, it is not needed anymore, in this section in
> https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040top-Command.html
> it is said that wrapping in @ifnootex ... "is no longer necessary, as
> the ‘Top’ node is now never output for printed output.".
> 
> --
> Pat

I recommend improving the structure of the documentation by first explaining 
what needs to be done now, followed by how it was done previously. This approach 
makes the documentation easier to follow.

Adding this structure also offers another key advantage: users can choose 
the level of detail they want. The main steps for the current method appear 
first, with more in-depth explanations available later as needed. This allows 
users to quickly find essential instructions and dive deeper only if they wish.