changeset 36479:20c3cd07c529 draft

runtime(doc): simplify vimtutor manpage a bit more Commit: https://github.com/vim/vim/commit/5ccac75d967e73669fd9dd5b83916a54a5989ae6 Author: Christian Brabandt <cb@256bit.org> Date: Mon Nov 4 21:02:42 2024 +0100 runtime(doc): simplify vimtutor manpage a bit more Signed-off-by: Christian Brabandt <cb@256bit.org>
author Christian Brabandt <cb@256bit.org>
date Mon, 04 Nov 2024 21:15:03 +0100
parents c1604f458177
children 9b763f36637a
files runtime/doc/vimtutor.1 runtime/doc/vimtutor.man
diffstat 2 files changed, 13 insertions(+), 43 deletions(-) [+]
line wrap: on
line diff
--- a/runtime/doc/vimtutor.1
+++ b/runtime/doc/vimtutor.1
@@ -1,4 +1,4 @@
-.TH VIMTUTOR 1 "2024 November 03"
+.TH VIMTUTOR 1 "2024 November 04"
 .SH NAME
 vimtutor \- the Vim tutor
 .SH SYNOPSIS
@@ -19,16 +19,8 @@ The
 is useful for people that want to learn their first
 .B Vim
 commands.
-.PP
-The optional argument \-g starts vimtutor with gvim rather than vim, if the
-GUI version of Vim is available, or falls back to vim if gvim is not found.
-.PP
 The optional [language] argument is the two-letter name of a language, like
 "it" or "es".
-If the [language] argument is missing, the language of the current locale will
-be used.
-If a tutor in this language is available, it will be used.
-Otherwise the English version will be used.
 .PP
 .B Vimtutor
 only opens temporary copies of the original tutor files, there is no danger of overwriting the lessons.
@@ -43,7 +35,7 @@ compatible mode.
 Set the two or three letter language code. E.g. 'it', 'es', 'bar'. Defaults to language of locale if available, else to English.
 .TP
 .BR \-c ", " \-\-chapter =\fINUMBER\fR
-Set the one or two digit chapter number. Defaults to chapter one.
+Set the chapter number. Defaults to chapter one.
 .TP
 .BR \-g ", " \-\-gui
 Start
@@ -88,7 +80,7 @@ The
 .B Vimtutor
 chapter one text file(s).
 .TP 15
-/usr/local/share/vim/vim??/tutor/tutor02[.language]
+/usr/local/share/vim/vim??/tutor/tutor2[.language]
 The
 .B Vimtutor
 chapter two text file(s).
@@ -98,18 +90,11 @@ The
 .B Vim
 script used to copy the
 .B Vimtutor
-chapter one text file.
-.TP 15
-/usr/local/share/vim/vim??/tutor/tutor02.vim
-The
-.B Vim
-script used to copy the
-.B Vimtutor
-chapter two text file.
+text file.
 .SH AUTHOR
 .B The Vi Tutorial
 was originally written for Vi by Michael C. Pierce and Robert K. Ware, Colorado School of Mines using ideas supplied by Charles Smith, Colorado State University.
-.B E-mail: bware@mines.colorado.edu.
+.B E-mail: bware@mines.colorado.edu (now invalid).
 .PP
 Modified for
 .B Vim
--- a/runtime/doc/vimtutor.man
+++ b/runtime/doc/vimtutor.man
@@ -13,17 +13,8 @@ DESCRIPTION
        Vimtutor starts the Vim tutor.
 
        The Vimtutor is useful for people that want to learn  their  first  Vim
-       commands.
-
-       The  optional argument -g starts vimtutor with gvim rather than vim, if
-       the GUI version of Vim is available, or falls back to vim  if  gvim  is
-       not found.
-
-       The  optional [language] argument is the two-letter name of a language,
-       like "it" or "es".  If the [language] argument is missing, the language
-       of the current locale will be used.  If a tutor  in  this  language  is
-       available,  it  will  be  used.   Otherwise the English version will be
-       used.
+       commands.  The optional [language] argument is the two-letter name of a
+       language, like "it" or "es".
 
        Vimtutor only opens temporary copies of the original tutor files, there
        is no danger of overwriting the lessons.
@@ -32,13 +23,12 @@ DESCRIPTION
 
 OPTIONS
        -l, --language=ISO639
-              Set the two or three letter  language  code.  E.g.  'it',  'es',
+              Set  the  two  or  three  letter language code. E.g. 'it', 'es',
               'bar'. Defaults to language of locale if available, else to Eng‐
               lish.
 
        -c, --chapter=NUMBER
-              Set  the  one  or  two digit chapter number. Defaults to chapter
-              one.
+              Set the chapter number. Defaults to chapter one.
 
        -g, --gui
               Start vimtutor in the GUI version of vim if available, otherwise
@@ -66,22 +56,17 @@ FILES
        /usr/local/share/vim/vim??/tutor/tutor[.language]
                       The Vimtutor chapter one text file(s).
 
-       /usr/local/share/vim/vim??/tutor/tutor02[.language]
+       /usr/local/share/vim/vim??/tutor/tutor2[.language]
                       The Vimtutor chapter two text file(s).
 
        /usr/local/share/vim/vim??/tutor/tutor.vim
-                      The Vim script used to copy  the  Vimtutor  chapter  one
-                      text file.
-
-       /usr/local/share/vim/vim??/tutor/tutor02.vim
-                      The  Vim  script  used  to copy the Vimtutor chapter two
-                      text file.
+                      The Vim script used to copy the Vimtutor text file.
 
 AUTHOR
        The Vi Tutorial was originally written for Vi by Michael C. Pierce  and
        Robert  K.  Ware,  Colorado  School  of  Mines  using ideas supplied by
        Charles Smith, Colorado  State  University.   E-mail:  bware@mines.col‐
-       orado.edu.
+       orado.edu (now invalid).
 
        Modified for Vim by Bram Moolenaar.
 
@@ -90,4 +75,4 @@ AUTHOR
 SEE ALSO
        vim(1)
 
-                               2024 November 03                    VIMTUTOR(1)
+                               2024 November 04                    VIMTUTOR(1)