The nroff documnetation for ls (/opt/ast/bin/ls --nroff 2>&1 | nroff
-man | less -s) appears to have a case of runaway underlining. It starts
with the -Z option in this phrase:

    %[−+][width[.precis[.base]]](id[:subformat])fIchar.

In src/lib/libcmd/ls.c the optget() text for this phrase appears as:

   
%[-+]][\awidth\a[.\aprecis\a[.\abase\a]]]]]](\aid\a[:\asubformat\a]])\achar\a.

This looks OK in my limited experience. I think this might be an
optget() translation error. That might explain the "fI" (fragment of a
t/nroff directive?) before "char".

    I'll leave the fix for this one to more experienced hands. It's
rather minor, anyway. But, if there's a bug in optget(), I thought you'd
like to know.

                    Terrence Doyle
--- src/cmd/ksh93/data/builtins.c.orig  2014-07-21 10:17:25.000000000 -0500
+++ src/cmd/ksh93/data/builtins.c       2015-01-10 18:49:25.000000000 -0600
@@ -437,7 +437,7 @@
     "specified with separate invocations of \bbuiltin\b. Libraries are "
     "searched in the reverse order in which they are specified.]"
 "[n?Disable each of the specified built-ins. Special built-ins cannot be "
-    "disabled.  If no built-ns are specifed, display all disabled built-ins.]]"
+    "disabled.  If no built-ns are specifed, display all disabled built-ins.]"
 "[l?List the library base name, plugin YYYYMMDD version stamp, and full "
     "path for \b-f\b\alib\a on one line on the standard output.]"
 "[p?Causes the output to be in a form of \bbuiltin\b commands that can be "
@@ -1330,7 +1330,7 @@
 "[A?Unset \avar\a and then create an indexed array containing each field in "
        "the line starting at index 0.]"
 "[C?Unset \avar\a and read  \avar\a as a compound variable.  Equivalent to "
-       "\b-aksh\b]"
+       "\b-mksh\b.]"
 "[a?Unset \avar\a and then create an indexed array containing each field in "
        "the line starting at index 0.]"
 "[d]:[delim?Read until delimiter \adelim\a instead of to the end of line.]"
@@ -1352,7 +1352,7 @@
        "a terminal or pipe.]"
 "[n]#[count?Read at most \acount\a characters.  For binary fields \acount\a "
        "is the number of bytes.]"
-"[N]#[count?Read exactly \ancount\a characters.  For binary fields \acount\a "
+"[N]#[count?Read exactly \acount\a characters.  For binary fields \acount\a "
        "is the number of bytes.]"
 "[v?When reading from a terminal the value of the first variable is displayed "
        "and used as a default value.]"
--- src/cmd/ksh93/edit/pcomplete.c.orig 2014-09-01 12:03:19.000000000 -0500
+++ src/cmd/ksh93/edit/pcomplete.c      2015-01-09 17:33:48.000000000 -0600
@@ -140,7 +140,7 @@
        "[+disabled?Names of disabled shell builtins.]"
        "[+enabled?Names of enabled shell builtins.]"
        "[+export?Equivalent to \b-e\b.]"
-       "[+file??Equivalent to \b-f\b.]"
+       "[+file?Equivalent to \b-f\b.]"
        "[+function?Names of shell functions.]"
        "[+group?Equivalent to \b-g\b.]"
        "[+helptopic?Help topics as accepted by the \bhelp\b builtin.]"
@@ -150,7 +150,7 @@
        "[+keyword?Equivalent to \b-k\b.]"
        "[+running?Names of running jobs if job control is active.]"
        "[+service?Equivalent to \b-s\b.]"
-       "[+setopt?Valid option names as acceptered by the \bshopt\b builtin.]"
+       "[+setopt?Valid option names as accepted by the \bshopt\b builtin.]"
        "[+signal?Signal names.]"
        "[+stopped?Names of stopped jobs if job control is active.]"
        "[+user?Equivalent to \b-u\b.]"
@@ -158,10 +158,10 @@
 "}"
 "[o]:[option?\aoption\a may be one of the following list of completions:]{"
        "[+bashdefault?perform \bbash\b default completions if there are no "
-               "matches]"
+               "matches.]"
        "[+default?Use default filename completion of there are no matches.]"
        "[+dirnames?Perform directory name completion if there are no matches.]"
-       "[+filenames?]"
+       "[+filenames?Perform filename completion if there are no matches.]"
        "[+nospace?No space will be appended to words completed at the end "
                "of the line.]"
 "}"
@@ -176,16 +176,15 @@
 "[D?Use this completion as a default for commands that don't have a completion 
"
        "specified.]"
 "[E?Use this completion when for a blank line.]"
-       "specified.]"
 "[F]:[function?The shell function \afunction\a is executed in the current "
        "environment.  When it finishes the possible list of completions are "
-       "retrieved from the indexed array variable \bCOMPREPLY\b]"
+       "retrieved from the indexed array variable \bCOMPREPLY\b.]"
 "[X]:[pattern?\apattern\a is used to filter filename expansions.  It is "
        "applied to the list of possible completions generated by the "
        "preceding options and arguments, and each completion matching "
        "\apattern\a is removed from the list.  A leading \b!\b in \apattern\a "
        "negates the pattern.]"
-"[P]:[prefix?\aprefix\a is prepended to each possible completion after all "
+"[P]:[prefix?\aprefix\a is prefixed to each possible completion after all "
        "other options have been applied.]"
 "[S]:[suffix?\asuffix\a is appended to each possible completion after all "
        "other options have been applied.]"
_______________________________________________
ast-developers mailing list
ast-developers@lists.research.att.com
http://lists.research.att.com/mailman/listinfo/ast-developers

Reply via email to