--- man1/intro.1 | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/man1/intro.1 b/man1/intro.1 index 72f28bc2e..5aad9d4e7 100644 --- a/man1/intro.1 +++ b/man1/intro.1 @@ -314,15 +314,17 @@ the previous page, and "q" to quit. In documentation it is customary to refer to man pages by using the name followed by the section number in brackets, as in .BR man (1). -Man pages are terse, and allow you to find quickly some forgotten -detail. -For newcomers an introductory text with more examples -and explanations is useful. .P -A lot of GNU/FSF software is provided with info files. -Type "info info" -for an introduction on the use of the program -.IR info . +Man pages are concise, and allow you to quickly find a forgotten detail. +They're designed to be a complete reference manual for a program. +Usually you'd want a guide/tutorial when learning how to use software, +rather than a long exhaustive reference manual. +For this purpose a lot of GNU software comes with +.I info +manuals, which are designed to be more of an introduction for newcomers. +Use the command "info info" for a first introduction on using the +.I info +program. .P Some topics can be documented in HOWTO files. To find these, look for HTML files in -- 2.44.0
