Reference
hidos <options> <subcommand> ...
Subcommands:
Subcommand commit
Amend the contents of a document snapshot as a new edition in a document succession.
hidos commit <path_to_contents> <branch_name> <edition_number>
Subcommand create
Create a document succession.
hidos create --keys <ssh_public_key_file> <new_branch_name>
See the guide to Create Signing Key for instructions on creating an SSH public key file.
A new Document Succession Identifier (DSI) will be displayed, and the git branch name can be used for further operations. The branch name is not intrinsic to the document succession and is for convenient identification of successions stored in a git repository.
For testing and trial purposes, you can create an unsigned document succession:
hidos --unsigned create <new_branch_name>
Read about the --unsigned
option for caveats.
Tip
You might not like a DSI that you create. Maybe you don't want 0
or O
characters,
or maybe you don't want l
or I
characters, because some fonts do not visually distinguish
them. Or maybe you don't want -
or _
characters. Whatever the reason, every second you
can regenerate a new DSI by:
- Deleting the just-created DSI:
git branch -D my_succession
- Creating a new DSI:
hidos create my_succession
Subcommand dsi
Display the DSI for a specific branch.
hidos dsi <branch_name>
To list all editions along with the SWHID of their binary content, use:
hidos dsi --editions <branch_name>
Subcommand find
Find remote public git repositories based on Document Succession Identifier.
hidos find <base_dsi>
Find remote git repositories and then add them as remotes to the local git repository.
hidos find --add <base_dsi>
A dsi:
prefix is optional for the parameter <base_dsi>
.
Subcommand list
List all document successions found in a git repository.
hidos list
Both a DSI and branch names will be printed for each document succession.
Hidos options
Option --unsigned
For evaluation and testing purposes, it is easier to create
unsigned document successions. To do this, use the --unsigned
option immediately
after hidos
on the subcommand line.
hidos --unsigned <subcommand> ...
Warning
For long-term public usage, it is necessary for document successions to
be signed. Otherwise, anybody can amend your document succession once it is public.
Use the create
subcommand with the --keys
option to create a signed document
succession.
Option --git-dir
If your current directory is in a git repository, then Hidos will use it by default
if no --git-dir
option is given.
Alternatively, you can use the --git-dir
option to explicitly point to the git repository.
hidos --git-dir <path_to_repo_dir> <subcommand> ...