Talk:Help text style guide

From Octave
(Redirected from Talk:Help text)
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Yes-or-no flag

Shouldn't we use logical instead of a double for such variable? --Franklin Yu (talk) 01:52, 5 February 2017 (PST)

That is not a point for the help text, it is the behaviour of individual functions. The fact is that pretty much all functions will simply check if the value is non-zero. --carandraug (talk) 04:43, 5 February 2017 (PST)


expanding on common @ codes

It might be useful to expand on or add a section on the use of the more common @ codes / macros, eg: @group, @example, @result. What type of things should use @code vs @math or @code{foo} vs @qcode{"foo"} (that last one i'm rarely sure about). @ref vs @xref, and what should go in the reference part of those. when we prefer a @table vs a @itemize. I don't think we have to recreate a Texinfo manual, but there are probably a number of others that we could document here so they are used consistently according to our style preferences. Nrjank (talk) 16:29, 2 February 2024 (UTC)