45a7b0f22c17a01908e40afd3fec303ec5961076
[autodist.git] / apps / autodist / doc / autodist.1.in
1 .TH AUTODIST "1" "April 2005" "@PACKAGE_NAME@ @VERSION@" "User Commands"
2 .SH NAME
3 Autodist \- Source distribution management system
4 .SH SYNOPSIS
5 .B autodist
6 [options] [distribution] [version]
7 .PP
8 .SH DESCRIPTION
9 .PP
10 The Autodist is a source distribution management system that allows 
11 powerful mechanisms to define what is included in and excluded from a 
12 distribution, and what license the distribution is released under.  It is 
13 also used to create the actual distribution source packages.  Autodist 
14 allows distribution management in file, directory and file content level.  
15 Different distributions may include different portions of files, for 
16 example, excluding certain features from certain distributions.  It is 
17 always guaranteed that anything not defined for the distribution, is 
18 removed automatically (files, file content, directories), thus ensuring 
19 that nothing is accidentally included in the distribution.
20 .PP
21 Autodist is closely related to the Autoconf and Automake tools, and 
22 complements the features Autoconf and Automake provides.  It is especially 
23 targeted into circumstances where multiple distributions are created from 
24 one source tree.  The Autoconf and Automake environment is mainly designed 
25 for one application per one source tree situations.  Autodist provides 
26 mechanisms to create all kinds of distributions that can be created from 
27 one source tree.  To be able to use Autodist, the Autoconf and Automake 
28 must be installed into the system.
29 .PP
30 .SH OPTIONS
31 .B Operation modes:
32 .PP
33 .TP
34 \fB\-h\fR, \fB\-\-help\fR
35 Prints the help for the Autodist and exits.
36 .PP
37 .TP
38 \fB\-V\fR, \fB\-\-version\fR
39 Prints version number and exits.
40 .PP
41 .TP
42 \fB\-v\fR, \fB\-\-verbose\fR
43 Verbosely report processing.
44 .PP
45 .TP
46 \fB\-d\fR, \fB\-\-distdir\fR
47 Search distributions from <dir> instead of default 'distdir'.
48 .PP
49 .TP
50 \fB\-s\fR, \fB\-\-distdefs\fR \fB[<dist>]\fR
51 Prints distribution defines of <dist> and exits.
52 .PP
53 .TP
54 \fB\-i\fR, \fB\-\-init\fR
55 Initializes Autodist environment.  Creates the default distribution
56 directory 'distdir', 'autodist.conf' configuration file and the
57 default distribution 'default', then exits.
58 .PP
59 .TP
60 \fB\-p\fR, \fB\-\-process\fR \fB<src>\fR \fB<dst>\fR
61 Process Makefile.ad file <src> into <dst> for distribution, the exits.
62 .PP
63 .TP
64 \fB\-m\fR, \fB\-\-makedist\fR
65 Creates and packages distribution
66 .PP
67 .TP
68 \fB\-\-gzip\fR
69 Create package compressed with gzip (default)
70 .PP
71 .TP
72 \fB\-\-bzip2\fR
73 Create also package compressed with bzip2
74 .PP
75 .TP
76 \fB\-\-compress\fR
77 Create also package compressed with compress
78 .PP
79 .TP
80 \fB\-\-zip\fR
81 Create also package compressed with zip
82 .SH COPYRIGHT
83 Copyright \(co 2005 Pekka Riikonen, SILC Project
84 .br
85 This is free software; see the source for copying conditions.  There is NO
86 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR 
87 PURPOSE.
88 .SH "SEE ALSO"
89 .BR autoconf (1),
90 .BR automake (1),
91 .PP
92 The full documentation for
93 .B autodist
94 is maintained as a Texinfo manual.  If the
95 .B info
96 and
97 .B autodist
98 programs are properly installed at your site, the command
99 .IP
100 .B info autodist
101 .PP
102 should give you access to the complete manual.