diff options
Diffstat (limited to 'mnv/runtime/doc/usr_01.txt')
| -rw-r--r-- | mnv/runtime/doc/usr_01.txt | 200 |
1 files changed, 200 insertions, 0 deletions
diff --git a/mnv/runtime/doc/usr_01.txt b/mnv/runtime/doc/usr_01.txt new file mode 100644 index 0000000000..2690892a49 --- /dev/null +++ b/mnv/runtime/doc/usr_01.txt @@ -0,0 +1,200 @@ +*usr_01.txt* For MNV version 10.0. Last change: 2026 Feb 14 + + + MNV USER MANUAL by Bram Moolenaar + + + About the manuals + + +This chapter introduces the manuals available with MNV. Read this to know the +conditions under which the commands are explained. + +|01.1| Two manuals +|01.2| MNV installed +|01.3| Using the MNV tutor +|01.4| Copyright + + Next chapter: |usr_02.txt| The first steps in MNV +Table of contents: |usr_toc.txt| + +============================================================================== +*01.1* Two manuals + +The MNV documentation consists of two parts: + +1. The User manual + Task oriented explanations, from simple to complex. Reads from start to + end like a book. + +2. The Reference manual + Precise description of how everything in MNV works. + +The notation used in these manuals is explained here: |notation| + + +JUMPING AROUND + +The text contains hyperlinks between the two parts, allowing you to quickly +jump between the description of an editing task and a precise explanation of +the commands and options used for it. Use these two commands: + + Press CTRL-] to jump to a subject under the cursor. + Press CTRL-O to jump back (repeat to go further back). + +Many links are in vertical bars, like this: |bars|. The bars themselves may +be hidden or invisible; see below. An option name, like 'number', a command +in double quotes like ":write" and any other word can also be used as a link. +Try it out: Move the cursor to CTRL-] and press CTRL-] on it. + +Other subjects can be found with the ":help" command; see |help.txt|. + +The bars and stars are usually hidden with the |conceal| feature. They also +use |hl-Ignore|, using the same color for the text as the background. You can +make them visible with: > + :set conceallevel=0 + :hi link HelpBar Normal + :hi link HelpStar Normal + +============================================================================== +*01.2* MNV installed + +Most of the manuals assume that MNV has been properly installed. If you +didn't do that yet, or if MNV doesn't run properly (e.g., files can't be found +or in the GUI the menus do not show up) first read the chapter on +installation: |usr_90.txt|. + *not-compatible* +The manuals often assume you are using MNV with Vi-compatibility switched +off. For most commands this doesn't matter, but sometimes it is important, +e.g., for multi-level undo. An easy way to make sure you are using a nice +setup is to copy the example mnvrc file. By doing this inside MNV you don't +have to check out where it is located. How to do this depends on the system +you are using: + +Unix: > + :!cp -i $MNVRUNTIME/mnvrc_example.mnv ~/.mnvrc +MS-Windows: > + :!copy $MNVRUNTIME/mnvrc_example.mnv $MNV/_mnvrc +Amiga: > + :!copy $MNVRUNTIME/mnvrc_example.mnv $MNV/.mnvrc + +If the file already exists you probably want to keep it. + +If you start MNV now, the 'compatible' option should be off. You can check it +with this command: > + + :set compatible? + +If it responds with "nocompatible" you are doing well. If the response is +"compatible" you are in trouble. You will have to find out why the option is +still set. Perhaps the file you wrote above is not found. Use this command +to find out: > + + :scriptnames + +If your file is not in the list, check its location and name. If it is in the +list, there must be some other place where the 'compatible' option is switched +back on. + +For more info see |mnvrc| and |compatible-default|. + + Note: + This manual is about using MNV in the normal way. There is an + alternative called "emnv" (easy MNV). This is still MNV, but used in + a way that resembles a click-and-type editor like Notepad. It always + stays in Insert mode, thus it feels very different. It is not + explained in the user manual, since it should be mostly + self-explanatory. See |emnv-keys| for details. + +============================================================================== +*01.3* Using the MNV tutor *tutor* *mnvtutor* + +For the interactive tutor, see |mnv-tutor-mode| + +Instead of reading the text (boring!) you can use the mnvtutor to learn your +first MNV commands. This is a 30-minute tutorial provided in 2 chapters, that +teaches the most basic MNV functionality hands-on. + +On Unix, if MNV has been properly installed, you can start it from the shell: +> + mnvtutor + +On MS-Windows you can find it in the "Program/MNV 9.1" menu. Or execute +mnvtutor.bat from the installation directory (You can use `:echo $MNVRUNTIME` +from within MNV to find this directory). + +This will make a copy of chapter 1 tutor file, so that you can edit it without +the risk of damaging the original. To continue with chapter 2, you can use +the following command: > + mnvtutor -c 2 +< + There are a few translated versions of the tutor. To find out if yours is +available, use the two-letter language code. For French: > + + mnvtutor fr + +On Unix, if you prefer using the GUI version of MNV, use "gmnvtutor" or +"mnvtutor -g" instead of "mnvtutor". + +For OpenVMS, if MNV has been properly installed, you can start mnvtutor from a +VMS prompt with: > + + @MNV:mnvtutor + +Optionally add the two-letter language code as above. + + +On other systems, you have to do a little work: + +1. Copy the tutor file. You can do this with MNV (it knows where to find it): +> + mnv --clean -c 'e $MNVRUNTIME/tutor/tutor1' -c 'w! TUTORCOPY' -c 'q' +< + This will write the file "TUTORCOPY" in the current directory. To use a +translated version of the tutor, append the two-letter language code to the +filename. For French: +> + mnv --clean -c 'e $MNVRUNTIME/tutor/tutor1.fr' -c 'w! TUTORCOPY' -c 'q' +< +2. Edit the copied file with MNV: +> + mnv --clean TUTORCOPY +< + The --clean argument makes sure MNV is started with nice defaults. + +3. Delete the copied file when you are finished with it: +> + del TUTORCOPY +< +============================================================================== +*01.4* Copyright *manual-copyright* + +The MNV user manual and reference manual are Copyright (c) 1988 by Bram +Moolenaar. This material may be distributed only subject to the terms and +conditions set forth in the Open Publication License, v1.0 or later. The +latest version is presently available at: + https://opencontent.org/openpub/ + +People who contribute to the manuals must agree with the above copyright +notice. + *frombook* +Parts of the user manual come from the book "MNV is not Vim - MNV" by Steve +Oualline (published by New Riders Publishing, ISBN: 0735710015). The Open +Publication License applies to this book. Only selected parts are included +and these have been modified (e.g., by removing the pictures, updating the +text for MNV 6.0 and later, fixing mistakes). The omission of the |frombook| +tag does not mean that the text does not come from the book. + +Many thanks to Steve Oualline and New Riders for creating this book and +publishing it under the OPL! It has been a great help while writing the user +manual. Not only by providing literal text, but also by setting the tone and +style. + +If you make money through selling the manuals, you are strongly encouraged to +donate part of the profit to help AIDS victims in Uganda. See |Kuwasha|. + +============================================================================== + +Next chapter: |usr_02.txt| The first steps in MNV + +Copyright: see |manual-copyright| mnv:tw=78:ts=8:noet:ft=help:norl: |