From: Michael Schroeder Date: Thu, 25 Sep 2014 14:53:06 +0000 (+0200) Subject: The last tools manpages X-Git-Tag: 0.6.6~3 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9dbf31dc2c671ccf338674e3e12165fd7331bdac;p=thirdparty%2Flibsolv.git The last tools manpages --- diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 4a24b878..13e086cd 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -14,6 +14,34 @@ 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_MANPAGES3} DESTINATION "${MAN_INSTALL_DIR}/man3") diff --git a/doc/Makefile.gen b/doc/Makefile.gen index b104131d..84a1095a 100644 --- a/doc/Makefile.gen +++ b/doc/Makefile.gen @@ -1,10 +1,12 @@ -man: man3 man1 +man: man3 man1 -man3: libsolv.3 libsolv-bindings.3 libsolv-constantids.3 libsolv-history.3 libsolv-pool.3 +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 +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 diff --git a/doc/appdata2solv.1 b/doc/appdata2solv.1 new file mode 100644 index 00000000..174e25ef --- /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 +.\" 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 diff --git a/doc/appdata2solv.txt b/doc/appdata2solv.txt new file mode 100644 index 00000000..3ccb4b57 --- /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 diff --git a/doc/archpkgs2solv.1 b/doc/archpkgs2solv.1 new file mode 100644 index 00000000..e4ef62d5 --- /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 +.\" 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 diff --git a/doc/archpkgs2solv.txt b/doc/archpkgs2solv.txt new file mode 100644 index 00000000..2a170665 --- /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 diff --git a/doc/archrepo2solv.1 b/doc/archrepo2solv.1 new file mode 100644 index 00000000..49878216 --- /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 +.\" 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 diff --git a/doc/archrepo2solv.txt b/doc/archrepo2solv.txt new file mode 100644 index 00000000..3f5b1384 --- /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 diff --git a/doc/comps2solv.1 b/doc/comps2solv.1 new file mode 100644 index 00000000..e8ec2f7c --- /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 +.\" 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 diff --git a/doc/comps2solv.txt b/doc/comps2solv.txt new file mode 100644 index 00000000..23e304e2 --- /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 diff --git a/doc/deb2solv.1 b/doc/deb2solv.1 new file mode 100644 index 00000000..4cfa0931 --- /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 +.\" 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 diff --git a/doc/deb2solv.txt b/doc/deb2solv.txt new file mode 100644 index 00000000..09073836 --- /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 diff --git a/doc/helix2solv.1 b/doc/helix2solv.1 new file mode 100644 index 00000000..5a8d6781 --- /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 +.\" 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 diff --git a/doc/helix2solv.txt b/doc/helix2solv.txt new file mode 100644 index 00000000..db8dfe9f --- /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 diff --git a/doc/libsolv-bindings.3 b/doc/libsolv-bindings.3 index bfb7f5bd..e0e0be68 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 -.\" Date: 04/04/2014 +.\" Date: 09/24/2014 .\" Manual: LIBSOLV .\" Source: libsolv .\" Language: English .\" -.TH "LIBSOLV\-BINDINGS" "3" "04/04/2014" "libsolv" "LIBSOLV" +.TH "LIBSOLV\-BINDINGS" "3" "09/24/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 @@ -1481,7 +1481,7 @@ Do not create stubs for repository parts that can be downloaded on demand\&. .PP \fBSUSETAGS_RECORD_SHARES\fR .RS 4 -This is specific to the add_susetags() method\&. Susetags allows one to refer to already read packages to save disk space\&. If this data sharing needs to work over multiple calls to add_susetags, you need to specify this flag so that the share information is made available to subsequent calls\&. +This is specific to the add_susetags() method\&. Susetags allows to refer to already read packages to save disk space\&. If this data sharing needs to work over multiple calls to add_susetags, you need to specify this flag so that the share information is made available to subsequent calls\&. .RE .SS "METHODS" .sp @@ -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 @@ -4675,7 +4690,7 @@ Return the size change of the installed system in kilobytes (kibibytes)\&. .RE .\} .sp -Order the steps in the transactions so that dependent packages are updated before packages that depend on them\&. For rpm, you can also use rpmlib\(cqs ordering functionality, debian\(cqs dpkg does not provide a way to order a transaction\&. +Order the steps in the transactions so that dependant packages are updated before packages that depend on them\&. For rpm, you can also use rpmlib\(cqs ordering functionality, debian\(cqs dpkg does not provide a way to order a transaction\&. .SS "ACTIVE/PASSIVE VIEW" .sp Active view list what new packages get installed, while passive view shows what happens to the installed packages\&. Most often there\(cqs not much difference between the two modes, but things get interesting of multiple package get replaced by one new package\&. Say you have installed package A\-1\-1 and B\-1\-1, and now install A\-2\-1 with has a new dependency that obsoletes B\&. The transaction elements will be diff --git a/doc/libsolv-bindings.txt b/doc/libsolv-bindings.txt index b4f5609e..ae7d4685 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 diff --git a/doc/mdk2solv.1 b/doc/mdk2solv.1 new file mode 100644 index 00000000..a32118a0 --- /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 +.\" 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 diff --git a/doc/mdk2solv.txt b/doc/mdk2solv.txt new file mode 100644 index 00000000..2616a87d --- /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 diff --git a/doc/rpmdb2solv.1 b/doc/rpmdb2solv.1 index b740002e..5057b579 100644 --- a/doc/rpmdb2solv.1 +++ b/doc/rpmdb2solv.1 @@ -2,12 +2,12 @@ .\" Title: rpmdb2solv .\" Author: [see the "Author" section] .\" Generator: DocBook XSL Stylesheets v1.78.0 -.\" Date: 09/24/2014 +.\" Date: 09/25/2014 .\" Manual: LIBSOLV .\" Source: libsolv .\" Language: English .\" -.TH "RPMDB2SOLV" "1" "09/24/2014" "libsolv" "LIBSOLV" +.TH "RPMDB2SOLV" "1" "09/25/2014" "libsolv" "LIBSOLV" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,10 +48,10 @@ instead of standard output\&. Print percentages as packages are being read in\&. The output format is like rpm\(cqs \-\-percent option\&. .RE .PP -\fB\-r\fR \fIROOT\fR +\fB\-r\fR \fIROOTDIR\fR .RS 4 Use -\fIROOT\fR +\fIROOTDIR\fR as root directory\&. .RE .PP diff --git a/doc/rpmdb2solv.txt b/doc/rpmdb2solv.txt index 2778199a..0c4585f7 100644 --- a/doc/rpmdb2solv.txt +++ b/doc/rpmdb2solv.txt @@ -26,8 +26,8 @@ Write the generated solv to 'OUTFILE' instead of standard output. Print percentages as packages are being read in. The output format is like rpm's --percent option. -*-r* 'ROOT':: -Use 'ROOT' as root directory. +*-r* 'ROOTDIR':: +Use 'ROOTDIR' as root directory. *-k*:: Read pubkeys from the rpm database instead of installed packages. diff --git a/doc/susetags2solv.1 b/doc/susetags2solv.1 new file mode 100644 index 00000000..9ec9510a --- /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 +.\" 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 diff --git a/doc/susetags2solv.txt b/doc/susetags2solv.txt new file mode 100644 index 00000000..9a2e2f1d --- /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 diff --git a/package/libsolv.spec.in b/package/libsolv.spec.in index 2d48277b..52924590 100644 --- a/package/libsolv.spec.in +++ b/package/libsolv.spec.in @@ -218,6 +218,7 @@ rm -rf "$RPM_BUILD_ROOT" %defattr(-,root,root) %if 0%{?suse_version} %exclude %{_bindir}/helix2solv +%exclude %{_mandir}/man1/helix2solv* %endif %exclude %{_bindir}/solv %{_bindir}/* @@ -236,6 +237,7 @@ rm -rf "$RPM_BUILD_ROOT" %{_includedir}/solv %if 0%{?suse_version} %{_bindir}/helix2solv +%{_mandir}/man1/helix2solv* %endif %{_datadir}/cmake/Modules/* %{_mandir}/man3/*