Update man page

Align it with `micro -help`.
This commit is contained in:
Dmytro Maluka
2025-07-21 01:07:44 +02:00
parent f735ff04b4
commit 20ebca9be4
2 changed files with 35 additions and 9 deletions

View File

@@ -1,10 +1,16 @@
.TH micro 1 "2020-02-10" .TH micro 1 "2025-08-16"
.SH NAME .SH NAME
micro \- A modern and intuitive terminal-based text editor micro \- A modern and intuitive terminal-based text editor
.SH SYNOPSIS .SH SYNOPSIS
.B micro .B micro
.RB [OPTIONS] .RB [OPTION]...\&
[FILE]\&... .RB [FILE]...\&
.RB [+LINE[:COL]]
.br
.B micro
.RB [OPTION]...\&
.RB [FILE[:LINE[:COL]]]...\&
\& (only if the `parsecursor` option is enabled)
.SH DESCRIPTION .SH DESCRIPTION
@@ -20,7 +26,7 @@ Use Ctrl-q to quit, Ctrl-s to save, and Ctrl-g to open the in-editor help menu.
.PP .PP
\-clean \-clean
.RS 4 .RS 4
Cleans the configuration directory Clean the configuration directory and exit
.RE .RE
.PP .PP
@@ -30,7 +36,9 @@ Specify a custom location for the configuration directory
.RE .RE
.PP .PP
[FILE]:LINE:COL FILE:LINE[:COL] (only if the `parsecursor` option is enabled)
.br
FILE +LINE[:COL]
.RS 4 .RS 4
Specify a line and column to start the cursor at when opening a buffer Specify a line and column to start the cursor at when opening a buffer
.RE .RE
@@ -38,7 +46,7 @@ Specify a line and column to start the cursor at when opening a buffer
.PP .PP
\-options \-options
.RS 4 .RS 4
Show all option help Show all options help and exit
.RE .RE
.PP .PP
@@ -47,15 +55,27 @@ Show all option help
Enable debug mode (enables logging to ./log.txt) Enable debug mode (enables logging to ./log.txt)
.RE .RE
.PP
\-profile
.RS 4
Enable CPU profiling (writes profile info to ./micro.prof so it can be analyzed later with "go tool pprof micro.prof")
.RE
.PP .PP
\-version \-version
.RS 4 .RS 4
Show the version number and information Show the version number and information and exit
.RE .RE
Micro's plugins can be managed at the command line with the following commands. Micro's plugins can be managed at the command line with the following commands.
.RS 4 .RS 4
.PP
\-plugin install [PLUGIN]...
.RS 4
Install plugin(s)
.RE
.PP .PP
\-plugin remove [PLUGIN]... \-plugin remove [PLUGIN]...
.RS 4 .RS 4
@@ -93,11 +113,16 @@ file (see 'help options').
.RS 4 .RS 4
.PP .PP
\-option value \-<option> value
.RS 4 .RS 4
Set `option` to `value` for this session Set `option` to `value` for this session.
.br
For example: `micro -syntax off file.c` For example: `micro -syntax off file.c`
.RE .RE
.RE
.PP
Use `micro -options` to see the full list of configuration options.
.SH CONFIGURATION .SH CONFIGURATION

View File

@@ -46,6 +46,7 @@ var (
) )
func InitFlags() { func InitFlags() {
// Note: keep this in sync with the man page in assets/packaging/micro.1
flag.Usage = func() { flag.Usage = func() {
fmt.Println("Usage: micro [OPTION]... [FILE]... [+LINE[:COL]]") fmt.Println("Usage: micro [OPTION]... [FILE]... [+LINE[:COL]]")
fmt.Println(" micro [OPTION]... [FILE[:LINE[:COL]]]... (only if the `parsecursor` option is enabled)") fmt.Println(" micro [OPTION]... [FILE[:LINE[:COL]]]... (only if the `parsecursor` option is enabled)")