Skip to content

Commit cb6101f

Browse files
committed
spell check files
1 parent 38ec10c commit cb6101f

File tree

3 files changed

+441
-111
lines changed

3 files changed

+441
-111
lines changed

notebook.1

Lines changed: 203 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,203 @@
1+
.\" Manpage for Standard (?) Unix Notes
2+
.\" aka notes
3+
.\" See https://github.com/Standard-Unix-Notes/unix-notes
4+
.TH notebook 1 "10 June 2021" "1.0" "Notes man page"
5+
.SH NAME
6+
Notes \- GPG encrypted notes
7+
.SH SYNOPSIS
8+
.B
9+
notebook
10+
[
11+
.IB
12+
command
13+
] [
14+
.I
15+
filename
16+
|
17+
.I \fInotebook_name\fP
18+
]
19+
20+
.SH DESCRIPTION
21+
22+
The Standard(?) Unix Notes notebook system is a GPG encrypted 'notebook' where each note
23+
is individually encrypted into a notebook folder. It can handle multiple notebook folders
24+
and can decrypt/re-encrypt for a new GPG key easily. The program is based upon
25+
Password-Store the standard Unix password manager of which it borrows some code.
26+
27+
If no command is given then \fBnotebook\fP simply runs 'notebook help' which outputs a
28+
list of commands to STDOUT.
29+
30+
31+
.SH COMMANDS
32+
33+
The notes program takes a set of commands which allows the user to manipulate the
34+
encrypted notes in the system.
35+
.RE
36+
37+
.SY help
38+
.YS
39+
Displays a quick help page displaying available commands.
40+
41+
.SY version
42+
.YS
43+
Displays the program version number.
44+
45+
.SY "show|ls|list"
46+
.YS
47+
List all notebooks in system.
48+
49+
.SY "default notebook"
50+
.YS
51+
.OP notebook
52+
Notebook will re-point the DEFAULT link to the specified notebook.
53+
.PP
54+
The default notebook is the notebook that will be used if no notebook is specified in the
55+
\fBnotebook used\fP command. This allows you to switch your default notebook for an period.
56+
Specifying a new default notebook has NO effect on the notebook the \fBnotes\fP command will use to add|import|copy|rename|remove a note file.
57+
58+
.SY "use [notebook]"
59+
.YS
60+
.OP notebook
61+
If a notebook is specified then Notebook then Notebook will change the USE link to the
62+
specified notebook. This will make all future note(1) operations act upon the new
63+
notebook.
64+
65+
.SY "insert|add notebook"
66+
.YS
67+
.OP notebook
68+
Add a notebook to the system. The program takes the notebook title and replaces any
69+
spaces within it with underscores before creating a notebook directory. Adding a notebook
70+
does NOT change where notes are added. You will need to change the USE notebook using the
71+
\fBnotebook use notebook-name\fP command.
72+
73+
.SY "rename|mv notebook"
74+
.YS
75+
.OP notebook
76+
Rename a notebook. Notebook will prompt for a new notebook title to be entered. Original
77+
encrypted notes are not changed as this only affects the directory name.
78+
79+
.SY "copy|cp notebook"
80+
.YS
81+
.OP notebook
82+
Duplicate a notebook in the SAME directory. The program will prompt for a new notebook title to
83+
be entered before copying the note to a new note title. The new notebook will be created with a copy of all notes in the original notebook directory.
84+
85+
.SY "delete|rm notebook"
86+
.YS
87+
.OP notebook
88+
Delete a notebook with the included notes inside.
89+
90+
.SH NOTES
91+
92+
The program comes with a sister program called \fBnotes\fP that is used to manage the
93+
notes inside the notebooks. See \fBnotes(1)\fP for details.
94+
95+
.SH OPTIONS
96+
97+
Most commands take a \fBnotebook\fP parameter. The notes and notebook commands strip
98+
spaces from note filenames and notebook directory names. It replaces them with
99+
underscores. This behaviour occurs even if the user encloses the notebook name with spaces in
100+
quotes because there are other issues that occur when handling notes with spaces in
101+
particularly when replacing the encryption key.
102+
103+
.SH EXIT STATUS
104+
105+
Upon an error notes returns a non zero value upon aborting.
106+
107+
.SH FILES
108+
109+
The following links point to the default and current notebooks.
110+
111+
.TP
112+
\fBDEFAULT\fP
113+
This link points to the default notebook (notes). This can be reassigned by using the
114+
command 'notebook default <notebook name>'.
115+
116+
117+
.TP
118+
\fBUSE \fP
119+
This link points to the currently used notebook. It can be changed by issuing the command
120+
'notebook use <notebook name>'. You can also set this to the default notebook by omitting
121+
the notebook name parameter.
122+
123+
.SH CONFORMANCE
124+
125+
The script is written to use the Bourne Shell and avoid all Bash-isms (which would have
126+
made the coding a little easier in some cases. Although Bash is installed by default on
127+
most Linuxes, it is not installed by default on a number of other Unix-like operating
128+
systems including FreeBSD.
129+
130+
This is deliberate as all Unix and Linux systems should have a POSIX compliant shell (or
131+
at least be backwards compatible to one). Hence the application was written for the
132+
lowest common denominator.
133+
134+
.SH NOTEBOOKS
135+
136+
There is currently no sync built into this application. However, the user can simply run
137+
a rsync or scp in order to synchronise between two machines running Notes.
138+
139+
.SH BUGS
140+
141+
See https://github.com/Standard-Unix-Notes/unix-notes/issues for details on any Bugs and
142+
Issues with the project.
143+
144+
Please report any bugs on the GitHub page.
145+
146+
.SH EXAMPLES
147+
148+
.EX
149+
Show help:
150+
\fB$ notebook\fP
151+
152+
Add a notebook called 'work'
153+
\fB$ notebook add work\fP
154+
155+
Add note called project_plans
156+
\fB$ notebook add project plans\fP
157+
158+
Rename notebook 'work':
159+
\fB$ notebook rename work\fP
160+
Please enter new name for note: installation instructions
161+
/home/ian/.notes/USE/mynote.gpg exists .... moving
162+
163+
List available notebooks:
164+
\fB$ notebook list\fP
165+
project_plans/ work_notes/
166+
167+
Delete a notebook:
168+
\fB$ notebook rm work notes\fP
169+
170+
.EE
171+
172+
.SH SEE ALSO
173+
174+
.IP \fBnotes(1)\fP The companion command for managing notes inside notebook(1).
175+
176+
177+
.SH PROJECT PAGE
178+
.UR https://github.com/Standard-Unix-Notes/unix-notes
179+
GitHub Project page
180+
.UE
181+
182+
.SS ROADMAP
183+
.UR https://github.com/Standard-Unix-Notes/unix-notes/raw/ROADMAP
184+
Project GitHub
185+
.UE
186+
187+
.SS CONTRIBUTING
188+
189+
Contributions are welcome, see CONTRIBUTING in the tarball or in the
190+
.UR https://github.com/Standard-Unix-Notes/unix-notes/raw/CONTRIBUTING
191+
GitHub repository
192+
.UE
193+
194+
.SS LICENCE
195+
196+
The Standard(?) Unix Notes program is licensed under the BSD 3-clause licence.
197+
198+
.SS AUTHOR
199+
200+
Ian Stanley can be contacted via project
201+
.UR https://github.com/iandstanley
202+
GitHub page
203+
.UE

notes

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
#
55
# This is Unix Notes. An GPG encrypted notes system designed for privacy
66
#
7-
# The idea came from 'pass' the standard unix password manager
7+
# The idea came from 'pass' the standard Unix password manager
88

99
# VARIABLES
1010
VERSION=1.0
@@ -23,7 +23,7 @@ PAGER="${PAGER:-more}"
2323
#SHREDCMD="shred"
2424

2525
#
26-
# initialize notes system
26+
# initialise notes system
2727
#
2828

2929
cmd_init (){ # setup directories and GPG key to be used
@@ -340,7 +340,7 @@ GPG encrypted notes system for BSD and Linux systems
340340
341341
SYSTEM:
342342
343-
notes init initialize notes system
343+
notes init initialise notes system
344344
notes config display config file
345345
notes newkey change GPG key
346346
notes help show help
@@ -353,7 +353,7 @@ NOTES MANAGEMENT:
353353
notes find|search find notes [YET TO BE IMPLEMENTED]
354354
notes insert|add note_title add a note
355355
notes view|cat note_title view a note
356-
notes import filepath import a text file as a note
356+
notes import file-path import a text file as a note
357357
notes rename|mv note_title rename a note (will prompt for new name)
358358
notes copy|cp note_title copy a note (will prompt for new name)
359359
notes delete|rm note_title delete a note

0 commit comments

Comments
 (0)