xref: /openbsd/usr.bin/vi/LAYOUT (revision a513d41b)
1#	@(#)LAYOUT	8.11 (Berkeley) 8/11/96
2
3LAYOUT
4	This file: the layout of the nvi sources.
5
6LICENSE
7	Nvi's copyright notice and conditions for redistribution.
8
9README
10	Welcome message and basic information.
11
12build/
13	The build/configuration directory for nvi.  See build/README for
14	more information.
15
16catalog/
17	Support for message catalogs for nvi.  See catalog/README for more
18	information.
19
20cl/
21	Source files for nvi's curses screen support.
22
23clib/
24	Replacement source files for C library functions.
25
26common/
27	Source files for pieces of code that are shared by ex and vi,
28	e.g., searching and logging code or code translating line numbers
29	into requests to the dbopen(3) database code.  It also has the
30	interface code for modifying "records" in the underlying database.
31
32curses/
33	A stripped-down replacement curses library.  Do not try and use
34	this library outside of nvi, many standard curses functions have
35	been removed because nvi doesn't use them.  See build/README for
36	more information.
37
38db/
39	A stripped-down replacement DB library.  Do not try and use this
40	library outside of nvi, many standard DB functions have been
41	removed because nvi doesn't use them.  See db/README for more
42	information.
43
44docs/
45	Ex/vi documentation, both current and historic.
46
47	USD.doc/
48		[USD stands for "User's Supplementary Documents".]
49
50		edit/   Roff source for "Edit: A tutorial".  This document
51			was USD:14 in the 4.3BSD manuals, but was not
52			distributed with 4.4BSD.
53
54		exref/  Roff source for "Ex Reference Manual -- Version
55			3.7".  This document was USD:16 in the 4.3BSD
56			manuals, and USD tabbed 12 in the 4.4BSD manuals.
57
58		vi.man/ Roff source for a UNIX manual page for nex/nvi.
59			An updated version of the 4.4BSD manual page.
60
61		vi.ref/ Roff source for the nex/nvi reference document.
62			An updated version of the 4.4BSD document, USD
63			tabbed 13.
64
65		vitut/  Roff source for "An Introduction to Display
66			Editing with Vi".  This document was USD:15 in
67			the 4.3BSD manuals, but was not distributed with
68			4.4BSD.  It includes the historic "Vi Quick
69			Reference" card.
70
71
72		PostScript preformatted versions of the nex/nvi reference
73		manual and manual page are in the files named with a ".ps"
74		suffix, in their respective source directories.  Flat text
75		preformatted versions of the nex/nvi reference manual and
76		manual page are in the files named with a ".txt" suffix,
77		in their respective source directories.
78
79	changelog	-- Log of changes from version to version.
80	features	-- Todo list, suggested features list.
81	internals/
82	    autowrite	-- Vi autowrite option discussion.
83	    context	-- Previous context marks discussion.
84	    gdb.script	-- GDB debugging scripts.
85	    input	-- Vi maps, executable buffers, and input discussion.
86	    openmode	-- Open mode behaviors.
87	    quoting	-- Vi quoting discussion.
88	    structures	-- Out-of-date nvi internal structure description.
89	tutorial/	-- Historic vi tutorial(s), of unknown quality.
90
91ex/
92	The ex source code.  Because vi has the colon command, lots of
93	this code is used by vi.  Generally, if functionality is shared
94	by both ex and vi, it's in the ex directory.  If it's vi only,
95	it's in the vi directory.  Files are generally named by the
96	command(s) they support, but occasionally with a name that
97	describes their functionality.
98
99	version.h	-- Version information.
100
101include/
102	Replacement include files:
103
104	bitstring.h	-- The 4.4BSD bitstring operations.
105	sys/queue.h	-- The 4.4BSD queue operations.
106
107install/
108	Things to install on the local system.
109
110	recover.script	-- Vi recovery script.
111
112perl_api/
113	Source code supporting the Perl scripting language for nvi.
114
115perl_scripts/
116	Scripts for Perl included with nvi.
117
118regex/
119	Henry Spencer's POSIX 1003.2 regular expression (RE) library.
120
121tcl_api/
122	Source code supporting the Tcl scripting language for nvi.
123
124tcl_scripts/
125	Scripts for Tcl included with nvi.
126
127tk/
128	Source files for nvi's Tk screen support.
129
130	init.tcl	-- Vi startup tcl script.
131
132vi/
133	The vi source code.
134