From afe08ff207c307ec76defeafa18635987bde2ab4 Mon Sep 17 00:00:00 2001 From: Dan Allen Date: Tue, 4 Jan 2022 01:59:04 -0700 Subject: document how the secondary names are handled by the manpage converter --- docs/modules/manpage-backend/pages/index.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/modules/manpage-backend/pages/index.adoc b/docs/modules/manpage-backend/pages/index.adoc index f1dccbb7..bf2a0481 100644 --- a/docs/modules/manpage-backend/pages/index.adoc +++ b/docs/modules/manpage-backend/pages/index.adoc @@ -37,8 +37,9 @@ There are several built-in document attributes that impact how the source is par Refer to the <> section. The NAME Section:: -The first section is mandatory, must be titled "`Name`" (or "`NAME`") and must contain a single paragraph (usually a single line) consisting of a list of one or more comma-separated command name(s) separated from the command purpose by a dash character (e.g., `progname - does stuff`). +The first section is mandatory, must be titled "`Name`" (or "`NAME`"), and must contain a single paragraph (usually a single line) consisting of a list of one or more comma-separated command name(s) separated from the command's purpose by a dash character (e.g., `progname - does stuff` or `name1, name2 - does stuff`). The dash must have at least one space character on either side. +If multiple names are given, Asciidoctor will generate alias files for the secondary names that point to the primary name. The SYNOPSIS Section:: The second section is recommended and, if present, must be titled "`Synopsis`" (or "`SYNOPSIS`"). -- cgit v1.2.3