You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
.\" See https://github.com/Standard-Unix-Notes/unix-notes
4
+
.TH man 1 "10 June 2021" "1.0" "notes man page"
5
+
.SH NAME
6
+
notes \- maintain GPG encrypted notes
7
+
.SH SYNOPSIS
8
+
notes [command] [filename | note title]
9
+
10
+
.SH CONFIGURATION
11
+
Manual configuration for the GPG key can be added using the phrase
12
+
KEY <email address>
13
+
in the file <notesdir>/config
14
+
.SH DESCRIPTION
15
+
The Standard(?) Unix Notes notebook system is a GPG encrypted 'notebook' where each note is individually encrypted into a notebook folder. It can handle multiple notebook folders and can decrypt/re-encrypt for a new GPG key easily. The program is based upon Password-Store the standard Unix password manager of which it borrows some code.
16
+
.SH COMMANDS
17
+
The notes program takes a set of commands which allows the user to manipulate the encrypted notes in the system.
18
+
.SH COMMANDS
19
+
init initialize notes system
20
+
newkey change GPG key
21
+
help show help
22
+
version show version
23
+
show|ls|list list notes in current notebook
24
+
newkey email change GPG key
25
+
26
+
find|search find notes [YET TO BE IMPLEMENTED]
27
+
insert|add note_title add a note
28
+
view|cat note_title view a note
29
+
import file import a text file as a note
30
+
rename|mv note_title rename a note (will prompt for new name)
31
+
copy|cp note_title copy a note (will prompt for new name)
32
+
delete|rm note_title delete a note
33
+
edit|ed note_title edit a note
34
+
35
+
36
+
37
+
38
+
.SH OPTIONS [Normally only in Sections 1, 8]
39
+
Most commands take either a <note title>, filename or a GPG key ID. See the individual COMMANDS for details on which options each command takes.
40
+
The notes and notebook commands strip spaces from note filenames and notebook directory names. It replaces them with underscores. This behaviour occurs even if the user encloses the filename with spaces in quotes because there are other issues that occur when handling notes with spaces in - particularly when replacing the encryption key.
41
+
.SH EXIT STATUS
42
+
Upon an error notes returns a non zero value upon aborting.
43
+
.SH ENVIRONMENT
44
+
$EDITOR Notes uses the shell variable to determine which editor the user prefers. If unset it will default to 'vi'
45
+
46
+
By default notes creates it's notes directory in ~/.notes for the user. This can be changed by midifying the shell script.
47
+
.SH FILES
48
+
The following files are found in the notes directory (~/.notes by default):
49
+
50
+
config The configuration file for notes. Currently the only option is for specifying the key to be used for encryption (KEY <email address>)
51
+
DEFAULT This link points to the default notebook (notes). This can be reassigned by using the command 'notebook default <notebook name>'
52
+
USE This link points to the currently used notebook. It can be changed by issuing the command 'notebook use <notebook name>'. You can also set this to the default notebook by omitting the notebook name parameter.
53
+
.SH VERSIONS [Normally only in Sections 2, 3]
54
+
55
+
.SH CONFORMING TO
56
+
The script is written to use the Bourne Shell and avoid all Bash-isms (which would have made the coding a little easier in some cases. Although Bash is installed by default on most Linuxes, it is not installed by default on a number of other Unix-like operating systems including FreeBSD.
57
+
58
+
This is deliberate as all Unix and Linux systems should have a POSIX compliant shell (or at least be backwards compatible to one). Hence the application was written for the lowest common denominator.
59
+
.SH NOTES
60
+
There is currently no sync built into this application. However, the user can simply run a rsync or scp in order to synchronize between two machines running Notes.
61
+
.SH BUGS
62
+
See https://github.com/Standard-Unix-Notes/unix-notes/issues for details on any Bugs and Issues with the project.
63
+
64
+
Please report any bugs on the GitHub page.
65
+
.SH EXAMPLES
66
+
67
+
.SH SEE ALSO
68
+
notebook The companion command for managing notebooks for notes. See notebook(1) for details.
0 commit comments