diff options
Diffstat (limited to 'doc')
42 files changed, 1707 insertions, 34 deletions
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index fc588e7..13e086c 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -1,8 +1,51 @@ -SET (libsolv_MANPAGES +SET (libsolv_MANPAGES3 libsolv.3 libsolv-bindings.3 libsolv-constantids.3 libsolv-history.3 libsolv-pool.3) +SET (libsolv_MANPAGES1 + mergesolv.1 dumpsolv.1 installcheck.1 testsolv.1) + +IF (ENABLE_RPMDB) +SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} rpmdb2solv.1 rpms2solv.1) +ENDIF (ENABLE_RPMDB) + +IF (ENABLE_RPMMD) +SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} repomdxml2solv.1 rpmmd2solv.1 updateinfoxml2solv.1 deltainfoxml2solv.1) +ENDIF (ENABLE_RPMMD) + +IF (ENABLE_HELIXREPO) +SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} helix2solv.1) +ENDIF (ENABLE_HELIXREPO) + +IF (ENABLE_SUSEREPO) +SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} susetags2solv.1) +ENDIF (ENABLE_SUSEREPO) + +IF (ENABLE_COMPS) +SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} comps2solv.1) +ENDIF (ENABLE_COMPS) + +IF (ENABLE_DEBIAN) +SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} deb2solv.1) +ENDIF (ENABLE_DEBIAN) + +IF (ENABLE_MDKREPO) +SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} mdk2solv.1) +ENDIF (ENABLE_MDKREPO) + +IF (ENABLE_ARCHREPO) +SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} archpkgs2solv.1 archrepo2solv.1) +ENDIF (ENABLE_ARCHREPO) + +IF (ENABLE_APPDATA) +SET (libsolv_MANPAGES1 ${libsolv_MANPAGES1} appdata2solv.1) +ENDIF (ENABLE_APPDATA) + INSTALL(FILES - ${libsolv_MANPAGES} + ${libsolv_MANPAGES3} DESTINATION "${MAN_INSTALL_DIR}/man3") + +INSTALL(FILES + ${libsolv_MANPAGES1} + DESTINATION "${MAN_INSTALL_DIR}/man1") diff --git a/doc/Makefile.gen b/doc/Makefile.gen index e18d0bc..84a1095 100644 --- a/doc/Makefile.gen +++ b/doc/Makefile.gen @@ -1,9 +1,19 @@ -man: libsolv.3 libsolv-bindings.3 libsolv-constantids.3 libsolv-history.3 libsolv-pool.3 +man: man3 man1 + +man3: libsolv.3 libsolv-bindings.3 libsolv-constantids.3 libsolv-history.3 libsolv-pool.3 + +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 html: libsolv.html libsolv-bindings.html libsolv-constantids.html libsolv-history.html libsolv-pool.html -.SUFFIXES: .html .3 .txt +.SUFFIXES: .html .3 .1 .txt + +.txt.1: + a2x -f manpage $< .txt.3: a2x -f manpage $< diff --git a/doc/appdata2solv.1 b/doc/appdata2solv.1 new file mode 100644 index 0000000..174e25e --- /dev/null +++ b/doc/appdata2solv.1 @@ -0,0 +1,58 @@ +'\" t +.\" Title: appdata2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/25/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "APPDATA2SOLV" "1" "09/25/2014" "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" +appdata2solv \- convert application meta data into a solv file +.SH "SYNOPSIS" +.sp +\fBappdata2solv\fR [\fIOPTIONS\fR] +.SH "DESCRIPTION" +.sp +The appdata format contains metadata about application\&. It can be available both in repositories (for available applications) and in the installed system (for installed applications)\&. The appdata2solv tool reads the metadata from stdin and writes the parsed data as solv file to standard output\&. The parser will create \fBapplication:\fR pseudo packages for each entry\&. +.PP +\fB\-d\fR \fIAPPDATADIR\fR +.RS 4 +Do not read from standard input, instead scan the specified directory for appdata entries\&. +\fIAPPDATADIR\fR +is normally set to +\fB/usr/share/appdata\fR\&. +.RE +.PP +\fB\-r\fR \fIROOTDIR\fR +.RS 4 +Use +\fIROOTDIR\fR +as root directory\&. +.RE +.SH "SEE ALSO" +.sp +mergesolv(1) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/appdata2solv.txt b/doc/appdata2solv.txt new file mode 100644 index 0000000..3ccb4b5 --- /dev/null +++ b/doc/appdata2solv.txt @@ -0,0 +1,39 @@ +appdata2solv(1) +=============== +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +appdata2solv - convert application meta data into a solv file + +Synopsis +-------- +*appdata2solv* ['OPTIONS'] + +Description +----------- +The appdata format contains metadata about application. It can +be available both in repositories (for available applications) +and in the installed system (for installed applications). +The appdata2solv tool reads the metadata from stdin and +writes the parsed data as solv file to standard output. The +parser will create *application:* pseudo packages for each entry. + +*-d* 'APPDATADIR':: +Do not read from standard input, instead scan the specified +directory for appdata entries. 'APPDATADIR' is normally +set to */usr/share/appdata*. + +*-r* 'ROOTDIR':: +Use 'ROOTDIR' as root directory. + + +See Also +-------- +mergesolv(1) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/archpkgs2solv.1 b/doc/archpkgs2solv.1 new file mode 100644 index 0000000..e4ef62d --- /dev/null +++ b/doc/archpkgs2solv.1 @@ -0,0 +1,59 @@ +'\" t +.\" Title: archpkgs2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/25/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "ARCHPKGS2SOLV" "1" "09/25/2014" "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" +archpkgs2solv \- convert one or more Arch package files into a solv file +.SH "SYNOPSIS" +.sp +\fBarchpkgs2solv\fR [\fIOPTIONS\fR] \fIPKG1\&.pkg\&.xz\fR \&... +.SH "DESCRIPTION" +.sp +The archpkgs2solv tool converts the meta data from one or more Arch Linux packages into the solv file written to standard output\&. +.PP +\fB\-m\fR \fIMANIFESTFILE\fR +.RS 4 +Read the rpm file names from the specified +\fIMANIFESTFILE\fR\&. You can use +\fB\-\fR +to read the manifest from standard input\&. +.RE +.PP +\fB\-0\fR +.RS 4 +Use a null byte as line terminator for manifest files instead of a newline\&. This is useful if the file names can contain newlines\&. See also the +\fB\-print0\fR +option in +\fBfind\fR\&. +.RE +.SH "SEE ALSO" +.sp +pacman(8) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/archpkgs2solv.txt b/doc/archpkgs2solv.txt new file mode 100644 index 0000000..2a17066 --- /dev/null +++ b/doc/archpkgs2solv.txt @@ -0,0 +1,35 @@ +archpkgs2solv(1) +================ +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +archpkgs2solv - convert one or more Arch package files into a solv file + +Synopsis +-------- +*archpkgs2solv* ['OPTIONS'] 'PKG1.pkg.xz' ... + +Description +----------- +The archpkgs2solv tool converts the meta data from one or more +Arch Linux packages into the solv file written to standard output. + +*-m* 'MANIFESTFILE':: +Read the rpm file names from the specified 'MANIFESTFILE'. You can +use *-* to read the manifest from standard input. + +*-0*:: +Use a null byte as line terminator for manifest files instead of +a newline. This is useful if the file names can contain newlines. +See also the *-print0* option in *find*. + +See Also +-------- +pacman(8) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/archrepo2solv.1 b/doc/archrepo2solv.1 new file mode 100644 index 0000000..4987821 --- /dev/null +++ b/doc/archrepo2solv.1 @@ -0,0 +1,52 @@ +'\" t +.\" Title: archrepo2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/25/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "ARCHREPO2SOLV" "1" "09/25/2014" "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" +archrepo2solv \- convert files in Arch repository format into a solv file +.SH "SYNOPSIS" +.sp +\fBarchrepo2solv\fR [\fIOPTIONS\fR] +.SH "DESCRIPTION" +.sp +The archrepo2solv tool reads Arch Linux repository data (\fBcore\&.db\fR) from stdin, and writes it as solv file to standard output\&. +.PP +\fB\-l\fR \fIDATABASEDIR\fR +.RS 4 +Instead of reading from standard input, scan the specified directory for package meta files\&. Set +\fIDATABASEDIR\fR +to +\fB/var/lib/pacman/local\fR +to scan the installed packages\&. +.RE +.SH "SEE ALSO" +.sp +pacman(8) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/archrepo2solv.txt b/doc/archrepo2solv.txt new file mode 100644 index 0000000..3f5b138 --- /dev/null +++ b/doc/archrepo2solv.txt @@ -0,0 +1,31 @@ +archrepo2solv(1) +================ +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +archrepo2solv - convert files in Arch repository format into a solv file + +Synopsis +-------- +*archrepo2solv* ['OPTIONS'] + +Description +----------- +The archrepo2solv tool reads Arch Linux repository data (*core.db*) from stdin, +and writes it as solv file to standard output. + +*-l* 'DATABASEDIR':: +Instead of reading from standard input, scan the specified directory for +package meta files. Set 'DATABASEDIR' to */var/lib/pacman/local* to +scan the installed packages. + +See Also +-------- +pacman(8) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/comps2solv.1 b/doc/comps2solv.1 new file mode 100644 index 0000000..e8ec2f7 --- /dev/null +++ b/doc/comps2solv.1 @@ -0,0 +1,43 @@ +'\" t +.\" Title: comps2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/25/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "COMPS2SOLV" "1" "09/25/2014" "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" +comps2solv \- convert rpm\-md comps\&.xml file into a solv file +.SH "SYNOPSIS" +.sp +\fBcomps2solv\fR [\fIOPTIONS\fR] +.SH "DESCRIPTION" +.sp +The comps\&.xml file is Fedora\(cqs way to implement package groups\&. The comps2solv tool reads the comps xml file from stdin and writes the parsed data as solv file to standard output\&. The parser will create \fBgroup:\fR and \fBcategory:\fR pseudo packages for each comps entry\&. +.SH "SEE ALSO" +.sp +mergesolv(1), createrepo(8) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/comps2solv.txt b/doc/comps2solv.txt new file mode 100644 index 0000000..23e304e --- /dev/null +++ b/doc/comps2solv.txt @@ -0,0 +1,29 @@ +comps2solv(1) +============= +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +comps2solv - convert rpm-md comps.xml file into a solv file + +Synopsis +-------- +*comps2solv* ['OPTIONS'] + +Description +----------- +The comps.xml file is Fedora's way to implement package groups. +The comps2solv tool reads the comps xml file from stdin and +writes the parsed data as solv file to standard output. The +parser will create *group:* and *category:* pseudo packages +for each comps entry. + +See Also +-------- +mergesolv(1), createrepo(8) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/deb2solv.1 b/doc/deb2solv.1 new file mode 100644 index 0000000..4cfa093 --- /dev/null +++ b/doc/deb2solv.1 @@ -0,0 +1,59 @@ +'\" t +.\" Title: deb2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/25/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "DEB2SOLV" "1" "09/25/2014" "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" +deb2solv \- convert one or more Debian package files into a solv file +.SH "SYNOPSIS" +.sp +\fBdeb2solv\fR [\fIOPTIONS\fR] \fIPKG1\&.deb\fR \&... +.SH "DESCRIPTION" +.sp +The deb2solv tool converts the meta data from one or more Debian packages into the solv file written to standard output\&. +.PP +\fB\-m\fR \fIMANIFESTFILE\fR +.RS 4 +Read the rpm file names from the specified +\fIMANIFESTFILE\fR\&. You can use +\fB\-\fR +to read the manifest from standard input\&. +.RE +.PP +\fB\-0\fR +.RS 4 +Use a null byte as line terminator for manifest files instead of a newline\&. This is useful if the file names can contain newlines\&. See also the +\fB\-print0\fR +option in +\fBfind\fR\&. +.RE +.SH "SEE ALSO" +.sp +deb(5), dpkg\-deb(1) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/deb2solv.txt b/doc/deb2solv.txt new file mode 100644 index 0000000..0907383 --- /dev/null +++ b/doc/deb2solv.txt @@ -0,0 +1,35 @@ +deb2solv(1) +============ +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +deb2solv - convert one or more Debian package files into a solv file + +Synopsis +-------- +*deb2solv* ['OPTIONS'] 'PKG1.deb' ... + +Description +----------- +The deb2solv tool converts the meta data from one or more +Debian packages into the solv file written to standard output. + +*-m* 'MANIFESTFILE':: +Read the rpm file names from the specified 'MANIFESTFILE'. You can +use *-* to read the manifest from standard input. + +*-0*:: +Use a null byte as line terminator for manifest files instead of +a newline. This is useful if the file names can contain newlines. +See also the *-print0* option in *find*. + +See Also +-------- +deb(5), dpkg-deb(1) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/deltainfoxml2solv.1 b/doc/deltainfoxml2solv.1 new file mode 100644 index 0000000..844c4fb --- /dev/null +++ b/doc/deltainfoxml2solv.1 @@ -0,0 +1,43 @@ +'\" t +.\" Title: deltainfoxml2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/24/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "DELTAINFOXML2SOLV" "1" "09/24/2014" "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" +deltainfoxml2solv \- convert rpm\-md\*(Aqs deltainfo format into a solv file +.SH "SYNOPSIS" +.sp +\fBdeltainfoxml2solv\fR [\fIOPTIONS\fR] +.SH "DESCRIPTION" +.sp +The deltainfoxml2solv tool reads rpm\-md\(cqs \fBdeltainfo\&.xml\fR data from stdin, and writes it as solv file to standard output\&. Some distributions name the input \fBprestodelta\&.xml\fR instead\&. Each delta rpm element is converted and added as \fBrepository:deltainfo\fR element to the meta section of the solv file\&. +.SH "SEE ALSO" +.sp +mergesolv(1), createrepo(8) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/deltainfoxml2solv.txt b/doc/deltainfoxml2solv.txt new file mode 100644 index 0000000..f14a843 --- /dev/null +++ b/doc/deltainfoxml2solv.txt @@ -0,0 +1,29 @@ +deltainfoxml2solv(1) +==================== +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +deltainfoxml2solv - convert rpm-md's deltainfo format into a solv file + +Synopsis +-------- +*deltainfoxml2solv* ['OPTIONS'] + +Description +----------- +The deltainfoxml2solv tool reads rpm-md's *deltainfo.xml* data from stdin, +and writes it as solv file to standard output. Some distributions name +the input *prestodelta.xml* instead. Each delta rpm element is converted +and added as *repository:deltainfo* element to the meta section of the +solv file. + +See Also +-------- +mergesolv(1), createrepo(8) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/dumpsolv.1 b/doc/dumpsolv.1 new file mode 100644 index 0000000..3e1400e --- /dev/null +++ b/doc/dumpsolv.1 @@ -0,0 +1,45 @@ +'\" t +.\" Title: dumpsolv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/22/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "DUMPSOLV" "1" "09/22/2014" "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" +dumpsolv \- print a solv file into a human readable format +.SH "SYNOPSIS" +.sp +\fBdumpsolv\fR [\fIOPTIONS\fR] [\fIFILE\&.solv\fR] +.SH "DESCRIPTION" +.sp +The dumpsolv tool reads a solv files and writes its contents to standard output\&. If no input file is given, it reads the solv file from standard input\&. +.PP +\fB\-j\fR +.RS 4 +Write the contents in JSON format\&. +.RE +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/dumpsolv.txt b/doc/dumpsolv.txt new file mode 100644 index 0000000..ec2d771 --- /dev/null +++ b/doc/dumpsolv.txt @@ -0,0 +1,26 @@ +dumpsolv(1) +=========== +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +dumpsolv - print a solv file into a human readable format + +Synopsis +-------- +*dumpsolv* ['OPTIONS'] ['FILE.solv'] + +Description +----------- +The dumpsolv tool reads a solv files and writes its contents +to standard output. If no input file is given, it reads the +solv file from standard input. + +*-j*:: +Write the contents in JSON format. + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/helix2solv.1 b/doc/helix2solv.1 new file mode 100644 index 0000000..5a8d678 --- /dev/null +++ b/doc/helix2solv.1 @@ -0,0 +1,40 @@ +'\" t +.\" Title: helix2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/24/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "HELIX2SOLV" "1" "09/24/2014" "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" +helix2solv \- convert legacy helixcode format into a solv file +.SH "SYNOPSIS" +.sp +\fBhelix2solv\fR +.SH "DESCRIPTION" +.sp +The helix format was a metadata format used in the RedCarpet package manager\&. It\(cqs still used in libzypp testcases\&. The helix2solv tool reads data in helix format from standhard input and write it in solv file format to standard output\&. +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/helix2solv.txt b/doc/helix2solv.txt new file mode 100644 index 0000000..db8dfe9 --- /dev/null +++ b/doc/helix2solv.txt @@ -0,0 +1,24 @@ +helix2solv(1) +============= +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +helix2solv - convert legacy helixcode format into a solv file + +Synopsis +-------- +*helix2solv* + +Description +----------- +The helix format was a metadata format used in the RedCarpet +package manager. It's still used in libzypp testcases. +The helix2solv tool reads data in helix format from standhard +input and write it in solv file format to standard output. + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/installcheck.1 b/doc/installcheck.1 new file mode 100644 index 0000000..85e4d89 --- /dev/null +++ b/doc/installcheck.1 @@ -0,0 +1,42 @@ +'\" t +.\" Title: installcheck +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/22/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "INSTALLCHECK" "1" "09/22/2014" "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" +installcheck \- find out which packages cannot be installed +.SH "SYNOPSIS" +.sp +\fBinstallcheck\fR \fIARCH\fR \fIREPO1\fR \fIREPO2\fR\&... \fB\-\-nocheck\fR \fINREPO1\fR \fINREPO2\fR\&... +.SH "DESCRIPTION" +.sp +The installcheck tool checks if all packages in \fIREPO1\fR\&...\fIREPON\fR are installable\&. A package is installable if there is a set of packages from the repositories that satisfies its dependencies\&. The repositories after the \fB\-\-nocheck\fR option are only used for dependency resolving, but the tool does not check if the packages in them are installable\&. +.sp +A Repository can be a solv file, a rpmmd \fBprimary\&.xml\&.gz\fR file, a SUSE \fBpackages\fR or \fBpackages\&.gz\fR file, or a Debian \fBPackages\fR or \fBPackages\&.gz\fR file\&. +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/installcheck.txt b/doc/installcheck.txt new file mode 100644 index 0000000..99eb279 --- /dev/null +++ b/doc/installcheck.txt @@ -0,0 +1,29 @@ +installcheck(1) +=============== +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +installcheck - find out which packages cannot be installed + +Synopsis +-------- +*installcheck* 'ARCH' 'REPO1' 'REPO2'... *--nocheck* 'NREPO1' 'NREPO2'... + +Description +----------- +The installcheck tool checks if all packages in 'REPO1'...'REPON' are +installable. A package is installable if there is a set of packages +from the repositories that satisfies its dependencies. The repositories +after the *--nocheck* option are only used for dependency resolving, +but the tool does not check if the packages in them are installable. + +A Repository can be a solv file, a rpmmd *primary.xml.gz* file, a SUSE +*packages* or *packages.gz* file, or a Debian *Packages* or *Packages.gz* +file. + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/libsolv-bindings.3 b/doc/libsolv-bindings.3 index 87e949a..1f52285 100644 --- a/doc/libsolv-bindings.3 +++ b/doc/libsolv-bindings.3 @@ -2,12 +2,12 @@ .\" Title: Libsolv-Bindings .\" Author: [see the "Author" section] .\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> -.\" Date: 04/04/2014 +.\" Date: 09/29/2014 .\" Manual: LIBSOLV .\" Source: libsolv .\" Language: English .\" -.TH "LIBSOLV\-BINDINGS" "3" "04/04/2014" "libsolv" "LIBSOLV" +.TH "LIBSOLV\-BINDINGS" "3" "09/29/2014" "libsolv" "LIBSOLV" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -307,7 +307,7 @@ Note that boolean methods have an added trailing \(lq?\(rq, to be consistent wit .RS 4 .\} .nf -\fBputs "empty\fR \fIrepo\fR\fB" if\fR \fIrepo\fR\fB\&.isempty?\fR +\fBputs "empty" if\fR \fIrepo\fR\fB\&.isempty?\fR .fi .if n \{\ .RE @@ -3435,6 +3435,21 @@ Make the SOLVER_FORCEBEST job option consider only packages that meet the polici .RS 4 Do not enable auto\-targeting up update and distupgrade jobs\&. See the section on targeted updates for more information\&. .RE +.PP +\fBSOLVER_FLAG_KEEP_ORPHANS\fR +.RS 4 +Do not allow orphaned packages to be deinstalled if they get in the way of resolving other packages\&. +.RE +.PP +\fBSOLVER_FLAG_BREAK_ORPHANS\fR +.RS 4 +Ignore dependencies of orphaned packages that get in the way of resolving non\-orphaned ones\&. Setting the flag might result in no longer working packages in case they are orphaned\&. +.RE +.PP +\fBSOLVER_FLAG_FOCUS_INSTALLED\fR +.RS 4 +Resolve installed packages before resolving the given job\&. Setting this flag means that the solver will prefer picking a package version that fits the other installed packages over updating installed packages\&. +.RE .sp Basic rule types: .PP @@ -3443,9 +3458,9 @@ Basic rule types: A rule of an unknown class\&. You should never encounter those\&. .RE .PP -\fBSOLVER_RULE_RPM\fR +\fBSOLVER_RULE_PKG\fR .RS 4 -A package dependency rule, called rpm rule for historical reasons\&. +A package dependency rule\&. .RE .PP \fBSOLVER_RULE_UPDATE\fR @@ -3485,47 +3500,47 @@ These rules are generated by the solver to keep it from running into the same pr .sp Special dependency rule types: .PP -\fBSOLVER_RULE_RPM_NOT_INSTALLABLE\fR +\fBSOLVER_RULE_PKG_NOT_INSTALLABLE\fR .RS 4 This rule was added to prevent the installation of a package of an architecture that does not work on the system\&. .RE .PP -\fBSOLVER_RULE_RPM_NOTHING_PROVIDES_DEP\fR +\fBSOLVER_RULE_PKG_NOTHING_PROVIDES_DEP\fR .RS 4 The package contains a required dependency which was not provided by any package\&. .RE .PP -\fBSOLVER_RULE_RPM_PACKAGE_REQUIRES\fR +\fBSOLVER_RULE_PKG_REQUIRES\fR .RS 4 -Similar to SOLVER_RULE_RPM_NOTHING_PROVIDES_DEP, but in this case some packages provided the dependency but none of them could be installed due to other dependency issues\&. +Similar to SOLVER_RULE_PKG_NOTHING_PROVIDES_DEP, but in this case some packages provided the dependency but none of them could be installed due to other dependency issues\&. .RE .PP -\fBSOLVER_RULE_RPM_SELF_CONFLICT\fR +\fBSOLVER_RULE_PKG_SELF_CONFLICT\fR .RS 4 The package conflicts with itself\&. This is not allowed by older rpm versions\&. .RE .PP -\fBSOLVER_RULE_RPM_PACKAGE_CONFLICT\fR +\fBSOLVER_RULE_PKG_CONFLICTS\fR .RS 4 To fulfill the dependencies two packages need to be installed, but one of the packages contains a conflict with the other one\&. .RE .PP -\fBSOLVER_RULE_RPM_SAME_NAME\fR +\fBSOLVER_RULE_PKG_SAME_NAME\fR .RS 4 The dependencies can only be fulfilled by multiple versions of a package, but installing multiple versions of the same package is not allowed\&. .RE .PP -\fBSOLVER_RULE_RPM_PACKAGE_OBSOLETES\fR +\fBSOLVER_RULE_PKG_OBSOLETES\fR .RS 4 To fulfill the dependencies two packages need to be installed, but one of the packages obsoletes the other one\&. .RE .PP -\fBSOLVER_RULE_RPM_IMPLICIT_OBSOLETES\fR +\fBSOLVER_RULE_PKG_IMPLICIT_OBSOLETES\fR .RS 4 To fulfill the dependencies two packages need to be installed, but one of the packages has provides a dependency that is obsoleted by the other one\&. See the POOL_FLAG_IMPLICITOBSOLETEUSESPROVIDES flag\&. .RE .PP -\fBSOLVER_RULE_RPM_INSTALLEDPKG_OBSOLETES\fR +\fBSOLVER_RULE_PKG_INSTALLED_OBSOLETES\fR .RS 4 To fulfill the dependencies a package needs to be installed that is obsoleted by an installed package\&. See the POOL_FLAG_NOINSTALLEDOBSOLETES flag\&. .RE diff --git a/doc/libsolv-bindings.txt b/doc/libsolv-bindings.txt index b4f5609..2b51635 100644 --- a/doc/libsolv-bindings.txt +++ b/doc/libsolv-bindings.txt @@ -138,7 +138,7 @@ Constants live in the namespace of the class they belong to: Note that boolean methods have an added trailing ``?'', to be consistent with other ruby modules: - puts "empty repo" if repo.isempty? + puts "empty" if repo.isempty? The Solv Class @@ -2101,8 +2101,8 @@ Basic rule types: *SOLVER_RULE_UNKNOWN*:: A rule of an unknown class. You should never encounter those. -*SOLVER_RULE_RPM*:: -A package dependency rule, called rpm rule for historical reasons. +*SOLVER_RULE_PKG*:: +A package dependency rule. *SOLVER_RULE_UPDATE*:: A rule to implement the update policy of installed packages. Every @@ -2142,43 +2142,43 @@ implementations. Special dependency rule types: -*SOLVER_RULE_RPM_NOT_INSTALLABLE*:: +*SOLVER_RULE_PKG_NOT_INSTALLABLE*:: This rule was added to prevent the installation of a package of an architecture that does not work on the system. -*SOLVER_RULE_RPM_NOTHING_PROVIDES_DEP*:: +*SOLVER_RULE_PKG_NOTHING_PROVIDES_DEP*:: The package contains a required dependency which was not provided by any package. -*SOLVER_RULE_RPM_PACKAGE_REQUIRES*:: -Similar to SOLVER_RULE_RPM_NOTHING_PROVIDES_DEP, but in this case +*SOLVER_RULE_PKG_REQUIRES*:: +Similar to SOLVER_RULE_PKG_NOTHING_PROVIDES_DEP, but in this case some packages provided the dependency but none of them could be installed due to other dependency issues. -*SOLVER_RULE_RPM_SELF_CONFLICT*:: +*SOLVER_RULE_PKG_SELF_CONFLICT*:: The package conflicts with itself. This is not allowed by older rpm versions. -*SOLVER_RULE_RPM_PACKAGE_CONFLICT*:: +*SOLVER_RULE_PKG_CONFLICTS*:: To fulfill the dependencies two packages need to be installed, but one of the packages contains a conflict with the other one. -*SOLVER_RULE_RPM_SAME_NAME*:: +*SOLVER_RULE_PKG_SAME_NAME*:: The dependencies can only be fulfilled by multiple versions of a package, but installing multiple versions of the same package is not allowed. -*SOLVER_RULE_RPM_PACKAGE_OBSOLETES*:: +*SOLVER_RULE_PKG_OBSOLETES*:: To fulfill the dependencies two packages need to be installed, but one of the packages obsoletes the other one. -*SOLVER_RULE_RPM_IMPLICIT_OBSOLETES*:: +*SOLVER_RULE_PKG_IMPLICIT_OBSOLETES*:: To fulfill the dependencies two packages need to be installed, but one of the packages has provides a dependency that is obsoleted by the other one. See the POOL_FLAG_IMPLICITOBSOLETEUSESPROVIDES flag. -*SOLVER_RULE_RPM_INSTALLEDPKG_OBSOLETES*:: +*SOLVER_RULE_PKG_INSTALLED_OBSOLETES*:: To fulfill the dependencies a package needs to be installed that is obsoleted by an installed package. See the POOL_FLAG_NOINSTALLEDOBSOLETES flag. diff --git a/doc/libsolv-constantids.3 b/doc/libsolv-constantids.3 index 45e717e..8511667 100644 --- a/doc/libsolv-constantids.3 +++ b/doc/libsolv-constantids.3 @@ -89,7 +89,7 @@ Stores an array of dependency Ids that describe the capabilities that also must .PP \fBSOLVABLE_RECOMMENDS "solvable:recommends"\fR .RS 4 -Stores an array of dependency Ids that describe the capabilities that also should be installed when this package is installed\&. It\(cqs not an error if not all capabilites can be met\&. +Stores an array of dependency Ids that describe the capabilities that also should be installed when this package is installed\&. It\(cqs not an error if not all capabilities can be met\&. .RE .PP \fBSOLVABLE_SUGGESTS "solvable:suggests"\fR diff --git a/doc/libsolv-pool.3 b/doc/libsolv-pool.3 index 748f112..0db9f8d 100644 --- a/doc/libsolv-pool.3 +++ b/doc/libsolv-pool.3 @@ -1241,7 +1241,7 @@ There can be multiple equivalence classes, the set of allowed vendor changes for You can turn off the architecture replacement checks with the Solver\(cqs SOLVER_FLAG_ALLOW_VENDORCHANGE flag\&. .SH "BOOLEAN DEPENDENCIES" .sp -Boolean Dependencies allow to build complex expressions from simple dependencies\&. While rpm does not support boolean expressions in dependencies and debian only allows an "OR" expression, libsolv allows to arbitrary complex expressions\&. The following basic types are supported: +Boolean Dependencies allow to build complex expressions from simple dependencies\&. While rpm does not support boolean expressions in dependencies and debian only allows an "OR" expression, libsolv allows one to arbitrary complex expressions\&. The following basic types are supported: .PP \fBREL_OR\fR .RS 4 diff --git a/doc/mdk2solv.1 b/doc/mdk2solv.1 new file mode 100644 index 0000000..a32118a --- /dev/null +++ b/doc/mdk2solv.1 @@ -0,0 +1,53 @@ +'\" t +.\" Title: mdk2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/25/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "MDK2SOLV" "1" "09/25/2014" "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" +mdk2solv \- convert files in Mandriva synthesis format into a solv file +.SH "SYNOPSIS" +.sp +\fBmdk2solv\fR [\fIOPTIONS\fR] +.SH "DESCRIPTION" +.sp +The mdk2solv tool reads Mandriva synthesis data (\fBhdlist\fR) from stdin, and writes it as solv file to standard output\&. +.PP +\fB\-i\fR \fIINFO\&.xml\fR +.RS 4 +Also read the info file containing url, license, and src information from the specified xml file\&. +.RE +.PP +\fB\-f\fR \fIFILES\&.xml\fR +.RS 4 +Also read filelist information from the specified xml file\&. +.RE +.SH "SEE ALSO" +.sp +genhdlist2(1) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/mdk2solv.txt b/doc/mdk2solv.txt new file mode 100644 index 0000000..2616a87 --- /dev/null +++ b/doc/mdk2solv.txt @@ -0,0 +1,33 @@ +mdk2solv(1) +=========== +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +mdk2solv - convert files in Mandriva synthesis format into a solv file + +Synopsis +-------- +*mdk2solv* ['OPTIONS'] + +Description +----------- +The mdk2solv tool reads Mandriva synthesis data (*hdlist*) from stdin, and writes +it as solv file to standard output. + +*-i* 'INFO.xml':: +Also read the info file containing url, license, and src information from +the specified xml file. + +*-f* 'FILES.xml':: +Also read filelist information from the specified xml file. + +See Also +-------- +genhdlist2(1) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/mergesolv.1 b/doc/mergesolv.1 new file mode 100644 index 0000000..e7cdd26 --- /dev/null +++ b/doc/mergesolv.1 @@ -0,0 +1,45 @@ +'\" t +.\" Title: mergesolv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/22/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "MERGESOLV" "1" "09/22/2014" "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" +mergesolv \- merge multiple files in solv format into a single one +.SH "SYNOPSIS" +.sp +\fBmergesolv\fR [\fIOPTIONS\fR] \fIFILE1\&.solv\fR \fIFILE2\&.solv\fR \&... +.SH "DESCRIPTION" +.sp +The mergesolv tool reads all solv files specified on the command line, and writes a merged version to standard output\&. +.PP +\fB\-X\fR +.RS 4 +Autoexpand SUSE pattern and product provides into packages\&. +.RE +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/mergesolv.txt b/doc/mergesolv.txt new file mode 100644 index 0000000..bbe8c72 --- /dev/null +++ b/doc/mergesolv.txt @@ -0,0 +1,25 @@ +mergesolv(1) +============ +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +mergesolv - merge multiple files in solv format into a single one + +Synopsis +-------- +*mergesolv* ['OPTIONS'] 'FILE1.solv' 'FILE2.solv' ... + +Description +----------- +The mergesolv tool reads all solv files specified on the command line, +and writes a merged version to standard output. + +*-X*:: +Autoexpand SUSE pattern and product provides into packages. + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/repomdxml2solv.1 b/doc/repomdxml2solv.1 new file mode 100644 index 0000000..d00fa02 --- /dev/null +++ b/doc/repomdxml2solv.1 @@ -0,0 +1,57 @@ +'\" t +.\" Title: repomdxml2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/24/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "REPOMDXML2SOLV" "1" "09/24/2014" "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" +repomdxml2solv \- convert a repomd\&.xml file into a solv file +.SH "SYNOPSIS" +.sp +\fBrepomdxml2solv\fR [\fIOPTIONS\fR] +.SH "DESCRIPTION" +.sp +The repomd\&.xml file is the index file of a rpm\-md repository, containing references to all data file with checksums\&. The repomdxml2solv tool reads the repomd\&.xml file from stdin and writes the parsed data as solv file to standard output\&. The data is stored as meta attributes in the result\&. +.PP +\fB\-q\fR \fIWHAT\fR +.RS 4 +Data query mode: instead of writing a solv file, select the +\fIWHAT\fR +element in the input data and write it to standard output\&. Examples for +\fIWHAT\fR +are +\fBtype\fR +to get a list of all types, and +\fBprimary:location\fR +to get the location of the element with type +\fBprimary\fR\&. +.RE +.SH "SEE ALSO" +.sp +rpmmd2solv(1), mergesolv(1), createrepo(8) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/repomdxml2solv.txt b/doc/repomdxml2solv.txt new file mode 100644 index 0000000..feb859c --- /dev/null +++ b/doc/repomdxml2solv.txt @@ -0,0 +1,36 @@ +repomdxml2solv(1) +================= +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +repomdxml2solv - convert a repomd.xml file into a solv file + +Synopsis +-------- +*repomdxml2solv* ['OPTIONS'] + +Description +----------- +The repomd.xml file is the index file of a rpm-md repository, +containing references to all data file with checksums. The +repomdxml2solv tool reads the repomd.xml file from stdin and +writes the parsed data as solv file to standard output. The +data is stored as meta attributes in the result. + +*-q* 'WHAT':: +Data query mode: instead of writing a solv file, select the +'WHAT' element in the input data and write it to standard output. +Examples for 'WHAT' are *type* to get a list of all types, and +*primary:location* to get the location of the element with +type *primary*. + +See Also +-------- +rpmmd2solv(1), mergesolv(1), createrepo(8) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/rpmdb2solv.1 b/doc/rpmdb2solv.1 new file mode 100644 index 0000000..5057b57 --- /dev/null +++ b/doc/rpmdb2solv.1 @@ -0,0 +1,95 @@ +'\" t +.\" Title: rpmdb2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/25/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "RPMDB2SOLV" "1" "09/25/2014" "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" +rpmdb2solv \- convert the rpm database into a solv file +.SH "SYNOPSIS" +.sp +\fBrpmdb2solv\fR [\fIOPTIONS\fR] [\fIREFFILE\&.solv\fR] +.SH "DESCRIPTION" +.sp +The rpmdb2solv tool reads rpm\(cqs installed packages database and writes it in solv file format to standard output\&. You can make use of an old version of the database by specifying a \fIREFFILE\&.solv\fR file\&. +.PP +\fB\-o\fR \fIOUTFILE\fR +.RS 4 +Write the generated solv to +\fIOUTFILE\fR +instead of standard output\&. +.RE +.PP +\fB\-P\fR +.RS 4 +Print percentages as packages are being read in\&. The output format is like rpm\(cqs \-\-percent option\&. +.RE +.PP +\fB\-r\fR \fIROOTDIR\fR +.RS 4 +Use +\fIROOTDIR\fR +as root directory\&. +.RE +.PP +\fB\-k\fR +.RS 4 +Read pubkeys from the rpm database instead of installed packages\&. Note that many distributions stopped storing pubkeys in the database but use a directory like +\fB/var/lib/rpm/pubkeys\fR +instead\&. +.RE +.PP +\fB\-A\fR +.RS 4 +Also scan the +\fB/usr/share/appdata\fR +for installed appdata files and create pseudo packages for each file\&. +.RE +.PP +\fB\-p\fR \fIPRODDIR\fR +.RS 4 +Also read SUSE product files from directory +\fIPRODDIR\fR\&. The standard directory is +\fB/etc/products\&.d\fR\&. +.RE +.PP +\fB\-n\fR +.RS 4 +Do not read any packages from the rpm database\&. This is useful together with +\fB\-p\fR +to only convert SUSE products\&. +.RE +.PP +\fB\-X\fR +.RS 4 +Autoexpand SUSE pattern and product provides into packages\&. +.RE +.SH "SEE ALSO" +.sp +rpms2solv(1) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/rpmdb2solv.txt b/doc/rpmdb2solv.txt new file mode 100644 index 0000000..0c4585f --- /dev/null +++ b/doc/rpmdb2solv.txt @@ -0,0 +1,59 @@ +rpmdb2solv(1) +============= +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +rpmdb2solv - convert the rpm database into a solv file + +Synopsis +-------- +*rpmdb2solv* ['OPTIONS'] ['REFFILE.solv'] + +Description +----------- +The rpmdb2solv tool reads rpm's installed packages database +and writes it in solv file format to standard output. You can +make use of an old version of the database by specifying a +'REFFILE.solv' file. + +*-o* 'OUTFILE':: +Write the generated solv to 'OUTFILE' instead of standard output. + +*-P*:: +Print percentages as packages are being read in. The output +format is like rpm's --percent option. + +*-r* 'ROOTDIR':: +Use 'ROOTDIR' as root directory. + +*-k*:: +Read pubkeys from the rpm database instead of installed packages. +Note that many distributions stopped storing pubkeys in the +database but use a directory like */var/lib/rpm/pubkeys* +instead. + +*-A*:: +Also scan the */usr/share/appdata* for installed appdata files +and create pseudo packages for each file. + +*-p* 'PRODDIR':: +Also read SUSE product files from directory 'PRODDIR'. The +standard directory is */etc/products.d*. + +*-n*:: +Do not read any packages from the rpm database. This is useful +together with *-p* to only convert SUSE products. + +*-X*:: +Autoexpand SUSE pattern and product provides into packages. + +See Also +-------- +rpms2solv(1) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/rpmmd2solv.1 b/doc/rpmmd2solv.1 new file mode 100644 index 0000000..249d801 --- /dev/null +++ b/doc/rpmmd2solv.1 @@ -0,0 +1,48 @@ +'\" t +.\" Title: rpmmd2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/24/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "RPMMD2SOLV" "1" "09/24/2014" "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" +rpmmd2solv \- convert files in rpm\-md format into a solv file +.SH "SYNOPSIS" +.sp +\fBrpmmd2solv\fR [\fIOPTIONS\fR] +.SH "DESCRIPTION" +.sp +The rpmmd2solv tool reads rpm\-md xml data from stdin, and writes it as solv file to standard output\&. It understands the \fBprimary\fR, \fBfilelist\fR, \fBother\fR, and \fBsusedata\fR format\&. +.PP +\fB\-X\fR +.RS 4 +Autoexpand SUSE pattern and product provides into packages\&. +.RE +.SH "SEE ALSO" +.sp +repomdxml2solv(1), mergesolv(1), createrepo(8) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/rpmmd2solv.txt b/doc/rpmmd2solv.txt new file mode 100644 index 0000000..c72ccc9 --- /dev/null +++ b/doc/rpmmd2solv.txt @@ -0,0 +1,30 @@ +rpmmd2solv(1) +============= +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +rpmmd2solv - convert files in rpm-md format into a solv file + +Synopsis +-------- +*rpmmd2solv* ['OPTIONS'] + +Description +----------- +The rpmmd2solv tool reads rpm-md xml data from stdin, and writes +it as solv file to standard output. It understands the *primary*, +*filelist*, *other*, and *susedata* format. + +*-X*:: +Autoexpand SUSE pattern and product provides into packages. + +See Also +-------- +repomdxml2solv(1), mergesolv(1), createrepo(8) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/rpms2solv.1 b/doc/rpms2solv.1 new file mode 100644 index 0000000..c6a2725 --- /dev/null +++ b/doc/rpms2solv.1 @@ -0,0 +1,80 @@ +'\" t +.\" Title: rpms2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/24/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "RPMS2SOLV" "1" "09/24/2014" "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" +rpms2solv \- convert one or more rpms into a solv file +.SH "SYNOPSIS" +.sp +\fBrpms2solv\fR [\fIOPTIONS\fR] \fIRPM1\&.rpm\fR \&... +.SH "DESCRIPTION" +.sp +The rpms2solv tool converts the header data from one or more rpms into the solv file written to standard output\&. +.PP +\fB\-m\fR \fIMANIFESTFILE\fR +.RS 4 +Read the rpm file names from the specified +\fIMANIFESTFILE\fR\&. You can use +\fB\-\fR +to read the manifest from standard input\&. +.RE +.PP +\fB\-0\fR +.RS 4 +Use a null byte as line terminator for manifest files instead of a newline\&. This is useful if the file names can contain newlines\&. See also the +\fB\-print0\fR +option in +\fBfind\fR\&. +.RE +.PP +\fB\-F\fR +.RS 4 +Do not put all files from the headers into the file list, but instead use the filtering also found in +\fBcreaterepo\fR\&. +.RE +.PP +\fB\-k\fR +.RS 4 +Read pubkeys instead of rpms\&. +.RE +.PP +\fB\-K\fR +.RS 4 +Read pubkey keyrings instead of rpms\&. +.RE +.PP +\fB\-X\fR +.RS 4 +Autoexpand SUSE pattern and product provides into packages\&. +.RE +.SH "SEE ALSO" +.sp +rpmdb2solv(1) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/rpms2solv.txt b/doc/rpms2solv.txt new file mode 100644 index 0000000..244dffb --- /dev/null +++ b/doc/rpms2solv.txt @@ -0,0 +1,48 @@ +rpms2solv(1) +============ +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +rpms2solv - convert one or more rpms into a solv file + +Synopsis +-------- +*rpms2solv* ['OPTIONS'] 'RPM1.rpm' ... + +Description +----------- +The rpms2solv tool converts the header data from one or more +rpms into the solv file written to standard output. + +*-m* 'MANIFESTFILE':: +Read the rpm file names from the specified 'MANIFESTFILE'. You can +use *-* to read the manifest from standard input. + +*-0*:: +Use a null byte as line terminator for manifest files instead of +a newline. This is useful if the file names can contain newlines. +See also the *-print0* option in *find*. + +*-F*:: +Do not put all files from the headers into the file list, but +instead use the filtering also found in *createrepo*. + +*-k*:: +Read pubkeys instead of rpms. + +*-K*:: +Read pubkey keyrings instead of rpms. + +*-X*:: +Autoexpand SUSE pattern and product provides into packages. + +See Also +-------- +rpmdb2solv(1) + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/susetags2solv.1 b/doc/susetags2solv.1 new file mode 100644 index 0000000..9ec9510 --- /dev/null +++ b/doc/susetags2solv.1 @@ -0,0 +1,66 @@ +'\" t +.\" Title: susetags2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/24/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "SUSETAGS2SOLV" "1" "09/24/2014" "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" +susetags2solv \- convert the susetags repository format into a solv file +.SH "SYNOPSIS" +.sp +\fBsusetags2solv\fR [\fIOPTIONS\fR] +.SH "DESCRIPTION" +.sp +The susetags format is most as repository format on most products created by SUSE\&. The susetags2solv reads data from standard input, converts the format into a solv file, and writes it to standard output\&. +.PP +\fB\-c\fR \fICONTENTFILE\fR +.RS 4 +Also parse the specified content file containing meta information about the repository\&. +.RE +.PP +\fB\-q\fR \fIWHAT\fR +.RS 4 +Data query mode: instead of writing a solv file, select the +\fIWHAT\fR +element in the input data and write it to standard output\&. An example for +\fIWHAT\fR +is +\fBdefaultvendor\fR +to get a default vendor for the repository\&. +.RE +.PP +\fB\-M\fR \fIMERGEFILE\&.solv\fR +.RS 4 +Merge the content of the specified solv file into the output\&. +.RE +.PP +\fB\-X\fR +.RS 4 +Autoexpand SUSE pattern and product provides into packages\&. +.RE +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/susetags2solv.txt b/doc/susetags2solv.txt new file mode 100644 index 0000000..9a2e2f1 --- /dev/null +++ b/doc/susetags2solv.txt @@ -0,0 +1,39 @@ +susetags2solv(1) +================ +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +susetags2solv - convert the susetags repository format into a solv file + +Synopsis +-------- +*susetags2solv* ['OPTIONS'] + +Description +----------- +The susetags format is most as repository format on most products +created by SUSE. The susetags2solv reads data from standard input, +converts the format into a solv file, and writes it to standard output. + +*-c* 'CONTENTFILE':: +Also parse the specified content file containing meta information +about the repository. + +*-q* 'WHAT':: +Data query mode: instead of writing a solv file, select the +'WHAT' element in the input data and write it to standard output. +An example for 'WHAT' is *defaultvendor* to get a default vendor for +the repository. + +*-M* 'MERGEFILE.solv':: +Merge the content of the specified solv file into the output. + +*-X*:: +Autoexpand SUSE pattern and product provides into packages. + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/testsolv.1 b/doc/testsolv.1 new file mode 100644 index 0000000..faf97b6 --- /dev/null +++ b/doc/testsolv.1 @@ -0,0 +1,62 @@ +'\" t +.\" Title: testsolv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/22/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "TESTSOLV" "1" "09/22/2014" "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" +testsolv \- run a libsolv testcase through the solver +.SH "SYNOPSIS" +.sp +\fBtestsolv\fR [\fIOPTIONS\fR] \fITESTCASE\fR +.SH "DESCRIPTION" +.sp +The testsolv tools can be used to run a testcase\&. Testcases can either be manually created to test specific features, or they can be written by libsolv\(cqs testcase_write function\&. This is useful to evaluate bug reports about the solver\&. +.PP +\fB\-v\fR +.RS 4 +Increase the debug level of the solver\&. This option can be specified multiple times to further increase the amount of debug data\&. +.RE +.PP +\fB\-r\fR +.RS 4 +Write the output in testcase format instead of human readable text\&. The output can then be used in the result section of the test case\&. If the +\fB\-r\fR +option is given twice, the output is formated for verbatim inclusion\&. +.RE +.PP +\fB\-l\fR \fIPKGSPEC\fR +.RS 4 +Instead of running the solver, list packages in the repositories\&. +.RE +.PP +\fB\-s\fR \fISOLUTIONSPEC\fR +.RS 4 +This is used in the solver test suite to test the calculated solutions to encountered problems\&. +.RE +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/testsolv.txt b/doc/testsolv.txt new file mode 100644 index 0000000..dc3a34e --- /dev/null +++ b/doc/testsolv.txt @@ -0,0 +1,41 @@ +testsolv(1) +=========== +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +testsolv - run a libsolv testcase through the solver + +Synopsis +-------- +*testsolv* ['OPTIONS'] 'TESTCASE' + +Description +----------- +The testsolv tools can be used to run a testcase. Testcases can +either be manually created to test specific features, or they +can be written by libsolv's testcase_write function. This is useful +to evaluate bug reports about the solver. + +*-v*:: +Increase the debug level of the solver. This option can be specified +multiple times to further increase the amount of debug data. + +*-r*:: +Write the output in testcase format instead of human readable text. +The output can then be used in the result section of the test case. +If the *-r* option is given twice, the output is formated for +verbatim inclusion. + +*-l* 'PKGSPEC':: +Instead of running the solver, list packages in the repositories. + +*-s* 'SOLUTIONSPEC':: +This is used in the solver test suite to test the calculated solutions +to encountered problems. + +Author +------ +Michael Schroeder <mls@suse.de> diff --git a/doc/updateinfoxml2solv.1 b/doc/updateinfoxml2solv.1 new file mode 100644 index 0000000..03c5cc7 --- /dev/null +++ b/doc/updateinfoxml2solv.1 @@ -0,0 +1,43 @@ +'\" t +.\" Title: updateinfoxml2solv +.\" Author: [see the "Author" section] +.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/> +.\" Date: 09/24/2014 +.\" Manual: LIBSOLV +.\" Source: libsolv +.\" Language: English +.\" +.TH "UPDATEINFOXML2SOLV" "1" "09/24/2014" "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" +updateinfoxml2solv \- convert rpm\-md\*(Aqs updateinfo\&.xml format into a solv file +.SH "SYNOPSIS" +.sp +\fBupdateinfoxml2solv\fR [\fIOPTIONS\fR] +.SH "DESCRIPTION" +.sp +The updateinfoxml2solv tool reads rpm\-md\(cqs updateinfo xml data from stdin, and writes it as solv file to standard output\&. Update elements are converted into special \fBpatch:\fR pseudo packages\&. +.SH "SEE ALSO" +.sp +mergesolv(1), createrepo(8) +.SH "AUTHOR" +.sp +Michael Schroeder <mls@suse\&.de> diff --git a/doc/updateinfoxml2solv.txt b/doc/updateinfoxml2solv.txt new file mode 100644 index 0000000..7e7c5fc --- /dev/null +++ b/doc/updateinfoxml2solv.txt @@ -0,0 +1,27 @@ +updateinfoxml2solv(1) +===================== +:man manual: LIBSOLV +:man source: libsolv + + +Name +---- +updateinfoxml2solv - convert rpm-md's updateinfo.xml format into a solv file + +Synopsis +-------- +*updateinfoxml2solv* ['OPTIONS'] + +Description +----------- +The updateinfoxml2solv tool reads rpm-md's updateinfo xml data from stdin, +and writes it as solv file to standard output. Update elements are converted +into special *patch:* pseudo packages. + +See Also +-------- +mergesolv(1), createrepo(8) + +Author +------ +Michael Schroeder <mls@suse.de> |