← Back to branch summary

~ubuntu-branches/ubuntu/vivid/nettle/vivid-proposed

« back to all changes in this revision

Viewing changes to debian/sexp-conv.1

  • Committer: Bazaar Package Importer
  • Author(s): Magnus Holmgren
  • Date: 2009-04-13 22:52:44 UTC
  • Revision ID: james.westby@ubuntu.com-20090413225244-ac20g0ggvlkmw2u4
Tags: 1.15-6
http://bugs.debian.org/510942
* No longer install sexp-conv as an alternative; conflict with lsh-utils
  prior to 2.0.4-dfsg-1, which depends on nettle-bin instead of shipping
  a copy of sexp-conv (Closes: #510942). Drop nettle-bin.postinst and
  nettle-bin.prerm (nettle-bin.prerm will remove the alternative on
  upgrade, which is actually a bug, but works out fine in this case).
* Switch to Debhelper level 5. Remove files that don't exist from install
  lists (copied from a template, apparently).
* Upgrade to Standards-Version 3.8.1:
  + Add debian/README.source (§ 4.9).
* Add debian/libnettle2.symbols.

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/sexp-conv.1
 
1
.\"                                      Hey, EMACS: -*- nroff -*-
 
2
.\" First parameter, NAME, should be all caps
 
3
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 
4
.\" other parameters are allowed: see man(7), man(1)
 
5
.TH SEXP\-CONV 1 "June 2007" "nettle 1.15"  "Nettle tools"
 
6
.\" Please adjust this date whenever revising the manpage.
 
7
.\"
 
8
.\" Some roff macros, for reference:
 
9
.\" .nh        disable hyphenation
 
10
.\" .hy        enable hyphenation
 
11
.\" .ad l      left justify
 
12
.\" .ad b      justify to both left and right margins
 
13
.\" .nf        disable filling
 
14
.\" .fi        enable filling
 
15
.\" .br        insert line break
 
16
.\" .sp <n>    insert n+1 empty lines
 
17
.\" for manpage-specific macros, see man(7)
 
18
.SH NAME
 
19
sexp\-conv \- convert s-expression to a different encoding
 
20
.SH SYNOPSIS
 
21
Conversion:
 
22
.br
 
23
.B sexp-conv
 
24
.RI [ OPTION ]... 
 
25
.RI <\  INPUT-SEXP
 
26
.PP
 
27
Fingerprinting:
 
28
.br
 
29
.B sexp-conv --hash\fR[\fB=\fP\fIalgorithm\fP]
 
30
.RI [ OPTION ]...
 
31
.RI <\  INPUT-SEXP
 
32
.SH DESCRIPTION
 
33
This manual page documents briefly the
 
34
.B sexp\-conv
 
35
command.
 
36
This manual page was written for the Debian GNU/Linux distribution
 
37
because the original program does not have a manual page.
 
38
Instead, it has documentation in the GNU Info format; see below.
 
39
.PP
 
40
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
 
41
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
 
42
.\" respectively.
 
43
\fBsexp\-conv\fP is a program that converts S-expressions. It automatically
 
44
detects the s-expression syntax variant of the input. It is primarily
 
45
used by the `lsh' packages, which stores keys and most other objects
 
46
on disk in that format, but may be of other use as well.
 
47
.SH OPTIONS
 
48
This program follows the usual GNU command line syntax, with long
 
49
options starting with two dashes (`-').
 
50
A summary of options is included below.
 
51
For a complete description, see the Info files.
 
52
.TP
 
53
.B \-\-hash=\fIalgorithm\fP
 
54
Output only the hash of the s-expression, using \fIalgorithm\fP (default: sha1).
 
55
.TP
 
56
.B \-\-raw\-hash
 
57
Alias for \-\-hash, for compatibility with lsh 1.x.
 
58
.TP
 
59
.B \-\-once
 
60
Process exactly one s-expression.
 
61
.TP
 
62
.B \-\-spki\-hash
 
63
Output an SPKI hash for the object. \fBNot yet implemented.\fP
 
64
.TP
 
65
.B \-s, \-\-syntax=\fIformat\fP
 
66
Variant of S-expression to output. Valid S-expression formats are: transport,
 
67
canonical (binary), advanced, and hex (same as advanced, but numbers in hex
 
68
instead of base64).
 
69
.TP
 
70
.B \-w, \-\-width=\fIwidth\fP
 
71
Limit output to lines of \fIwidth\fP characters (has no effect on canonical syntax). Zero means no limit.
 
72
.TP
 
73
.B \-?, \-\-help
 
74
Show summary of options.
 
75
.TP
 
76
.B \-V, \-\-version
 
77
Show version of program.
 
78
.SH SEE ALSO
 
79
.BR ssh-conv (1),
 
80
.BR lsh (1),
 
81
.BR lshd (8),
 
82
http://theworld.com/~cme/spki.txt.
 
83
.br
 
84
The programs are documented fully by the
 
85
.IR "sexp"
 
86
section under the
 
87
.IR "Getting Started"
 
88
header of the lsh info page, available via the Info system.
 
89
.SH BUGS
 
90
This program should be documented in the nettle manual, not in the lsh manual.
 
91
.SH AUTHOR
 
92
This manual page was originally written by Timshel Knoll <timshel@debian.org>,
 
93
for the Debian GNU/Linux system (but may be used by others). Edited
 
94
by Magnus Holmgren <magnus@kibibyte.se>.