From b3ea9efb73c63ef28d890c0b10d70cf8beedc27a Mon Sep 17 00:00:00 2001 From: Michael Schroeder Date: Mon, 16 Jul 2018 21:51:07 +0200 Subject: [PATCH] Add repo2solv manpage --- doc/CMakeLists.txt | 2 +- doc/Makefile.gen | 2 +- doc/gen/libsolv-pool.3 | 6 ++-- doc/gen/repo2solv.1 | 79 ++++++++++++++++++++++++++++++++++++++++++ doc/repo2solv.txt | 60 ++++++++++++++++++++++++++++++++ 5 files changed, 144 insertions(+), 5 deletions(-) create mode 100644 doc/gen/repo2solv.1 create mode 100644 doc/repo2solv.txt diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index b18596dd..738a0408 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -4,7 +4,7 @@ SET (libsolv_MANPAGES3 libsolv-pool.3) SET (libsolv_MANPAGES1 - mergesolv.1 dumpsolv.1 installcheck.1 testsolv.1) + mergesolv.1 dumpsolv.1 installcheck.1 testsolv.1 repo2solv.1) IF (ENABLE_RPMDB) SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} rpmdb2solv.1 rpms2solv.1) diff --git a/doc/Makefile.gen b/doc/Makefile.gen index 2e8c4a10..ec2880e6 100644 --- a/doc/Makefile.gen +++ b/doc/Makefile.gen @@ -8,7 +8,7 @@ man3: libsolv.3 libsolv-bindings.3 libsolv-constantids.3 libsolv-history.3 libso man1: mergesolv.1 dumpsolv.1 installcheck.1 testsolv.1 rpmdb2solv.1 rpms2solv.1 \ rpmmd2solv.1 repomdxml2solv.1 updateinfoxml2solv.1 deltainfoxml2solv.1 \ helix2solv.1 susetags2solv.1 comps2solv.1 deb2solv.1 mdk2solv.1 \ - archpkgs2solv.1 archrepo2solv.1 appdata2solv.1 + archpkgs2solv.1 archrepo2solv.1 appdata2solv.1 repo2solv.1 html: libsolv.html libsolv-bindings.html libsolv-constantids.html libsolv-history.html libsolv-pool.html diff --git a/doc/gen/libsolv-pool.3 b/doc/gen/libsolv-pool.3 index c0e14278..c64eeb1c 100644 --- a/doc/gen/libsolv-pool.3 +++ b/doc/gen/libsolv-pool.3 @@ -1,13 +1,13 @@ '\" t .\" Title: Libsolv-Pool .\" Author: [see the "Author" section] -.\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 01/18/2018 +.\" Generator: DocBook XSL Stylesheets vsnapshot +.\" Date: 07/16/2018 .\" Manual: LIBSOLV .\" Source: libsolv .\" Language: English .\" -.TH "LIBSOLV\-POOL" "3" "06/27/2018" "libsolv" "LIBSOLV" +.TH "LIBSOLV\-POOL" "3" "07/16/2018" "libsolv" "LIBSOLV" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/doc/gen/repo2solv.1 b/doc/gen/repo2solv.1 new file mode 100644 index 00000000..5f21465f --- /dev/null +++ b/doc/gen/repo2solv.1 @@ -0,0 +1,79 @@ +'\" t +.\" Title: repo2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets vsnapshot +.\" Date: 07/16/2018 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "REPO2SOLV" "1" "07/16/2018" "libsolv" "LIBSOLV" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +repo2solv \- convert repository metadata into a solv file +.SH "SYNOPSIS" +.sp +\fBrepo2solv\fR [\fIOPTIONS\fR] \fIDIR\fR +.SH "DESCRIPTION" +.sp +The repo2solv tool converts repository metadata in the directory \fIDIR\fR into a solv file written to standard output\&. +.sp +Note that repo2solv does not verify signatures or checksum, it is expected that this is done by the tool that downloads the metadata\&. +.sp +If no metadata is detected, repo2solv assumes the "plaindir" format and generates the solv file from all rpm files it finds\&. +.PP +\fB\-o\fR \fIOUTFILE\fR +.RS 4 +Write the solv file to +\fIOUTFILE\fR +instead of stdout\&. +.RE +.PP +\fB\-R\fR +.RS 4 +Also recurse into subdirectories in "plaindir" mode\&. +.RE +.PP +\fB\-F\fR +.RS 4 +Put the complete filelist in the output\&. The default is to just include the "importent" parts of the file list, except for "plaindir" mode, which always includes all files\&. +.RE +.PP +\fB\-C\fR +.RS 4 +Add changelog entires to the output\&. +.RE +.PP +\fB\-A\fR +.RS 4 +Add appdata pseudo packages to the output\&. This is an experimental feature\&. +.RE +.PP +\fB\-X\fR +.RS 4 +Autoexpand SUSE pattern and product provides into packages\&. +.RE +.SH "SEE ALSO" +.sp +dumpsolv(1) +.SH "AUTHOR" +.sp +Michael Schroeder diff --git a/doc/repo2solv.txt b/doc/repo2solv.txt new file mode 100644 index 00000000..3b2145fe --- /dev/null +++ b/doc/repo2solv.txt @@ -0,0 +1,60 @@ +repo2solv(1) +============ +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +repo2solv - convert repository metadata into a solv file + +Synopsis +-------- +*repo2solv* ['OPTIONS'] 'DIR' + +Description +----------- +The repo2solv tool converts repository metadata in the directory +'DIR' into a solv file written to standard output. + +Note that repo2solv does not verify signatures or checksum, it +is expected that this is done by the tool that downloads the +metadata. + +If no metadata is detected, repo2solv assumes the "plaindir" +format and generates the solv file from all rpm files it +finds. + +*-o* 'OUTFILE':: +Write the solv file to 'OUTFILE' instead of stdout. + +*-R*:: +Also recurse into subdirectories in "plaindir" mode. + +*-F*:: +Put the complete filelist in the output. The default is +to just include the "importent" parts of the file list, +except for "plaindir" mode, which always includes all +files. + +*-C*:: +Add changelog entires to the output. + +*-A*:: +Add appdata pseudo packages to the output. This is an +experimental feature. + +*-X*:: +Autoexpand SUSE pattern and product provides into packages. + +See Also +-------- +dumpsolv(1) + +Author +------ +Michael Schroeder + +//// +vim: syntax=asciidoc +//// -- 2.47.2