From 0e57f0c510b7d7eb688695359048a1f0a585e26a Mon Sep 17 00:00:00 2001 From: rmanfredi Date: Thu, 24 Aug 2006 12:32:52 +0000 Subject: Moving project to sourceforge. git-svn-id: svn://svn.code.sf.net/p/dist/code/trunk/dist@1 2592e710-e01b-42a5-8df0-11608a6cc53d --- kit/makedist.man | 147 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 147 insertions(+) create mode 100644 kit/makedist.man (limited to 'kit/makedist.man') diff --git a/kit/makedist.man b/kit/makedist.man new file mode 100644 index 0000000..0a13318 --- /dev/null +++ b/kit/makedist.man @@ -0,0 +1,147 @@ +.rn '' }` +''' $Id: makedist.man,v 3.0.1.2 1995/05/12 11:58:16 ram Exp ram $ +''' +''' Copyright (c) 1991-1997, 2004-2006, Raphael Manfredi +''' +''' You may redistribute only under the terms of the Artistic Licence, +''' as specified in the README file that comes with the distribution. +''' You may reuse parts of this distribution only within the terms of +''' that same Artistic Licence; a copy of which may be found at the root +''' of the source tree for dist 4.0. +''' +''' $Log: makedist.man,v $ +''' Revision 3.0.1.2 1995/05/12 11:58:16 ram +''' patch54: updated my e-mail address +''' +''' Revision 3.0.1.1 1994/05/06 14:00:50 ram +''' patch23: now mentions kitpost and kitsend +''' +''' Revision 3.0 1993/08/18 12:04:31 ram +''' Baseline for dist 3.0 netwide release. +''' +''' +.de Sh +.br +.ne 5 +.PP +\fB\\$1\fR +.PP +.. +.de Sp +.if t .sp .5v +.if n .sp +.. +''' +''' Set up \*(-- to give an unbreakable dash; +''' string Tr holds user defined translation string. +''' Bell System Logo is used as a dummy character. +''' +.ie n \{\ +.tr \(*W-\*(Tr +.ds -- \(*W- +.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +.ds L" "" +.ds R" "" +.ds L' ' +.ds R' ' +'br\} +.el\{\ +.ds -- \(em\| +.tr \*(Tr +.ds L" `` +.ds R" '' +.ds L' ` +.ds R' ' +'br\} +.TH MAKEDIST 1 LOCAL +.SH NAME +makedist \- a distribution kit maker +.SH SYNOPSIS +.B makedist +[ \fB\-dhqvV\fR ] [ \fB\-c\fI dir\fR ] +[ \fB\-s\fI size\fR ] [\fB\-f \fImanifest\fR ] +.SH DESCRIPTION +.I Makedist +is a rather simpleminded shar program that knows how to pack files +into multiple kits of approximately 50000 bytes each. +The shar scripts produced assume very little about the target machine; +there is correspondingly little error checking done compared to other +shar programs. Alternatively, with the \fB\-c\fR option, you can +create a directory containing the whole source tree, and then pack it +up using your own shell archiver. +.PP +If you are using the copyright expansion feature (as determined by +\fIpackinit\fR), then you have to pack your distribution using this +program to ensure the copyright is correctly set. +.PP +In order to run \fImakedist\fR you have to do two things: +.IP 1) 4 +Create a .package file in the package's top-level directory by running +\fIpackinit\fR. +This program will ask you about your package and remember what you tell +it so that all the \fIdist\fR programs can be smart. +.IP 2) 4 +Create a MANIFEST.new file in your top-level directory that lists all the +files in your package. +The filename should be the first field on each line. +After some whitespace you can add a comment describing your file (briefly). +.PP +After running \fImakedist\fR, +you will have a set of kits in your top-level directory. +If your package name is "foo", they will be named foo.kit1, foo.kit2, etc. +The file created PACKLIST file is automatically added to the distribution and +tells which files come with which kits. +If you used the \fB\-c\fR option, you will end-up with a single directory +instead, containing the whole distribution, ready to be sent to the end-user. +.PP +If a file is too large to be packed as-is in one archive, it will be +automatically split in smaller parts. Only the first 11 characters of the file +will be kept though, and \fImakedist\fR will abort if two distinct files are +to be split and have the same 11 first characters in their names. The split +files will automatically be reconstructed at the end of the archive extraction +by runnning a script generated in PACKNOTES. +.PP +You may then mail your kits via \fIkitsend\fR or post them with \fIkitpost\fR. +.SH OPTIONS +The following options are handled by \fImakedist\fR: +.TP 10 +.B \-c \fIdir\fR +Tell \fImakedist\fR that the distribution should be copied (mirrored) in +the specified directory, instead of producing shell archives. Compatible with +the \fB\-q\fR option. +.TP +.B \-d +Turn on debug mode. Probably not useful. +.TP +\fB-f\fI file\fR +Use \fIfile\fR as manifest. By default, MANIFEST.new is used. +.TP +.B \-h +Print help message and exit. +.TP +.B \-q +Quick production of the kits: the checked-out version of the files is used, +instead of using the RCS file to actually get the latest checked-in version. +This will save some considerable time, but you have to be sure the checked-out +version is up-to-date or you might end up with an inconsistent package. +.TP +\fB\-s\fI size\fR +Set maximum kit size to \fIsize\fR bytes. +.TP +.B \-v +Verbose mode: trace kit building process or tree mirroring. +.TP +.B \-V +Print version number and exit. +.SH AUTHORS +Larry Wall (version 2.0) +.br +Raphael Manfredi +.SH FILES +Creates ./$package.kit* unless \fB\-c\fR option is used. +.br +PACKLIST and PACKNOTES are also temporarily created. +.SH "SEE ALSO" +kitsend(1), kitpost(1), metaconfig(1), patcol(1) +.rn }` '' -- cgit v1.2.3 From f8465795cd1398d8150f7d80099e9a0182cb9b29 Mon Sep 17 00:00:00 2001 From: rmanfredi Date: Fri, 25 Aug 2006 21:39:07 +0000 Subject: Added keyword substitution property. git-svn-id: svn://svn.code.sf.net/p/dist/code/trunk/dist@3 2592e710-e01b-42a5-8df0-11608a6cc53d --- kit/makedist.man | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'kit/makedist.man') diff --git a/kit/makedist.man b/kit/makedist.man index 0a13318..17af969 100644 --- a/kit/makedist.man +++ b/kit/makedist.man @@ -1,5 +1,5 @@ .rn '' }` -''' $Id: makedist.man,v 3.0.1.2 1995/05/12 11:58:16 ram Exp ram $ +''' $Id$ ''' ''' Copyright (c) 1991-1997, 2004-2006, Raphael Manfredi ''' -- cgit v1.2.3 From d527baa7163e2a896b69c9e7eff90607cc145059 Mon Sep 17 00:00:00 2001 From: Raphael Manfredi Date: Sat, 13 May 2017 22:47:48 +0200 Subject: Updated places listing obsolete email addresses of mine. --- kit/makedist.man | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'kit/makedist.man') diff --git a/kit/makedist.man b/kit/makedist.man index 17af969..5c6b09d 100644 --- a/kit/makedist.man +++ b/kit/makedist.man @@ -137,7 +137,7 @@ Print version number and exit. .SH AUTHORS Larry Wall (version 2.0) .br -Raphael Manfredi +Raphael Manfredi .SH FILES Creates ./$package.kit* unless \fB\-c\fR option is used. .br -- cgit v1.2.3 From 607d9bfd575f3cf99789042a232669951f24a562 Mon Sep 17 00:00:00 2001 From: Dominic Hargreaves Date: Mon, 21 May 2018 11:05:13 +0200 Subject: Fix man page comment schema (#17) The commenting scheme used in the man pages was three consecutive single quotes (`'''') at the beginning of a line. his works, but `gtroff' gives a warning about an undefined macro (namely `'''), which is harmless, but irritating. To avoid this, this commit changes the schema to start the line with `.\"' which causes the line to be treated as an undefined request and thus ignored completely. Signed-off-by: Manoj Srivastava [updated to current dist by Dominic Hargreaves ] --- kit/makedist.man | 52 ++++++++++++++++++++++++++-------------------------- 1 file changed, 26 insertions(+), 26 deletions(-) (limited to 'kit/makedist.man') diff --git a/kit/makedist.man b/kit/makedist.man index 5c6b09d..280b42c 100644 --- a/kit/makedist.man +++ b/kit/makedist.man @@ -1,25 +1,25 @@ .rn '' }` -''' $Id$ -''' -''' Copyright (c) 1991-1997, 2004-2006, Raphael Manfredi -''' -''' You may redistribute only under the terms of the Artistic Licence, -''' as specified in the README file that comes with the distribution. -''' You may reuse parts of this distribution only within the terms of -''' that same Artistic Licence; a copy of which may be found at the root -''' of the source tree for dist 4.0. -''' -''' $Log: makedist.man,v $ -''' Revision 3.0.1.2 1995/05/12 11:58:16 ram -''' patch54: updated my e-mail address -''' -''' Revision 3.0.1.1 1994/05/06 14:00:50 ram -''' patch23: now mentions kitpost and kitsend -''' -''' Revision 3.0 1993/08/18 12:04:31 ram -''' Baseline for dist 3.0 netwide release. -''' -''' +.\" $Id$ +.\" +.\" Copyright (c) 1991-1997, 2004-2006, Raphael Manfredi +.\" +.\" You may redistribute only under the terms of the Artistic Licence, +.\" as specified in the README file that comes with the distribution. +.\" You may reuse parts of this distribution only within the terms of +.\" that same Artistic Licence; a copy of which may be found at the root +.\" of the source tree for dist 4.0. +.\" +.\" $Log: makedist.man,v $ +.\" Revision 3.0.1.2 1995/05/12 11:58:16 ram +.\" patch54: updated my e-mail address +.\" +.\" Revision 3.0.1.1 1994/05/06 14:00:50 ram +.\" patch23: now mentions kitpost and kitsend +.\" +.\" Revision 3.0 1993/08/18 12:04:31 ram +.\" Baseline for dist 3.0 netwide release. +.\" +.\" .de Sh .br .ne 5 @@ -31,11 +31,11 @@ .if t .sp .5v .if n .sp .. -''' -''' Set up \*(-- to give an unbreakable dash; -''' string Tr holds user defined translation string. -''' Bell System Logo is used as a dummy character. -''' +.\" +.\" Set up \*(-- to give an unbreakable dash; +.\" string Tr holds user defined translation string. +.\" Bell System Logo is used as a dummy character. +.\" .ie n \{\ .tr \(*W-\*(Tr .ds -- \(*W- -- cgit v1.2.3