diff --git a/doc/nano.texi b/doc/nano.texi index ff6f7c8cad1cb496bbe2147491f9f9c3681274b1..227672163303718d57b6bb5b2a1bde1294bee058 100644 --- a/doc/nano.texi +++ b/doc/nano.texi @@ -933,14 +933,14 @@ file. This functionality only works when libmagic is installed on the system and will be silently ignored otherwise. @item comment "string" -Use the given string for commenting and uncommenting lines. A vertical bar or -pipe character (@t{|}) designates bracket-style comments; for example, @t{"/*|*/"} for +Use the given string for commenting and uncommenting lines. +If the string contains a vertical bar or pipe character (@t{|}), +this designates bracket-style comments; for example, @t{"/*|*/"} for CSS files. The characters before the pipe are prepended to the line and the characters after the pipe are appended at the end of the line. If no pipe -character is present, the entire string is prepended; for example, @t{"#"} for +character is present, the full string is prepended; for example, @t{"#"} for Python files. If empty double quotes are specified, the comment/uncomment -functions are disabled; for example, @t{""} for JSON. Backslashes and double quotes -should be escaped with a backslash; for example, @t{".\\\""} for man page source. +functions are disabled; for example, @t{""} for JSON. The default value is @t{"#"}. @item color fgcolor,bgcolor "regex" @dots{} diff --git a/doc/nanorc.5 b/doc/nanorc.5 index 32568d85077bf34f407d04e85932d4b32c971d1e..d46439bbdc95b0e131b07f49b119da9e9d465256 100644 --- a/doc/nanorc.5 +++ b/doc/nanorc.5 @@ -329,14 +329,14 @@ functionality only works when \fBlibmagic\fP is installed on the system and will be silently ignored otherwise. .TP .BI comment " string" -Use the given string for commenting and uncommenting lines. A vertical bar or -pipe character (\fB|\fP) designates bracket-style comments; for example, "\fB/*|*/\fP" for +Use the given string for commenting and uncommenting lines. +If the string contains a vertical bar or pipe character (\fB|\fR), +this designates bracket-style comments; for example, "\fB/*|*/\fR" for CSS files. The characters before the pipe are prepended to the line and the characters after the pipe are appended at the end of the line. If no pipe -character is present, the entire string is prepended; for example, "\fB#\fP" for -Python files. If empty double quotes are specified, the comment/uncomment -function is disabled; for example, "" for JSON. Backslashes and double quotes -should be escaped with a backslash; for example, "\fB.\\\"\fP" for man page source. +character is present, the full string is prepended; for example, "\fB#\fR" +for Python files. If empty double quotes are specified, the comment/uncomment +function is disabled; for example, "" for JSON. The default value is "\fB#\fP". .TP .B color \fIfgcolor\fR,\fIbgcolor\fR """\fIregex\fR""" ... diff --git a/syntax/groff.nanorc b/syntax/groff.nanorc index f97a1ca231201066e99e3b2988e9ec0db5cca077..109f9cd6be4be314270478cbd5fdb6e174f9b2ca 100644 --- a/syntax/groff.nanorc +++ b/syntax/groff.nanorc @@ -1,7 +1,7 @@ ## Here is an example for groff. syntax "groff" "\.m[ems]$" "\.rof" "\.tmac$" "^tmac." -comment ".\\\"" +comment ".\"" # The argument of .ds or .nr color cyan "^\.(ds|nr) [^[:space:]]*" diff --git a/syntax/man.nanorc b/syntax/man.nanorc index e5da5becd21a38a1c4bd8a14b7c6f5df3872cc79..dd7d23ea5a615c8e119cf5ca356cdb0d2d3eeebc 100644 --- a/syntax/man.nanorc +++ b/syntax/man.nanorc @@ -2,7 +2,7 @@ syntax "man" "\.[1-9]x?$" magic "troff or preprocessor input text" -comment ".\\\"" +comment ".\"" color green "\.(SH|SS|TH) .*$" color brightgreen "\.(SH|SS|TH) " "\.([HIT]P)"