| commit | cdd9b3c96cc4a01bbc5f2f778e75028ea67a5f91 | |
| author | Jonathan Nieder <jrnieder@gmail.com> | |
| Sat, 9 Mar 2013 21:55:37 +0000 (9 13:55 -0800) | ||
| committer | Junio C Hamano <gitster@pobox.com> | |
| Sun, 10 Mar 2013 04:59:27 +0000 (9 20:59 -0800) | ||
| tree | 28e1cc48de6b6372620637d473a12dd968de5b74 | treesnapshot (tar.gz zip) |
| parent | 901fd180c9d19025bafefc34e131125628169bdd | commitdiff |
shell doc: emphasize purpose and security model
The original git-shell(1) manpage emphasized that the shell supports
only git transport commands. As the shell gained features, that
emphasis and focus in the manual has been lost. Bring it back by
splitting the manpage into a few short sections and fleshing out each:
- SYNOPSIS, describing how the shell gets used in practice
- DESCRIPTION, which gives an overview of the purpose and guarantees
provided by this restricted shell
- COMMANDS, listing supported commands and restrictions on the
arguments they accept
- INTERACTIVE USE, describing the interactive mode
Also add a "see also" section with related reading.
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
The original git-shell(1) manpage emphasized that the shell supports
only git transport commands. As the shell gained features, that
emphasis and focus in the manual has been lost. Bring it back by
splitting the manpage into a few short sections and fleshing out each:
- SYNOPSIS, describing how the shell gets used in practice
- DESCRIPTION, which gives an overview of the purpose and guarantees
provided by this restricted shell
- COMMANDS, listing supported commands and restrictions on the
arguments they accept
- INTERACTIVE USE, describing the interactive mode
Also add a "see also" section with related reading.
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
| Documentation/git-shell.txt | diffblobblamehistory |