Decompress manpage data
authorNeal Gompa (ニール・ゴンパ) <ngompa13@gmail.com>
Sun, 8 Nov 2015 13:46:26 +0000 (08:46 -0500)
committerNeal Gompa (ニール・ゴンパ) <ngompa13@gmail.com>
Sun, 8 Nov 2015 13:46:26 +0000 (08:46 -0500)
The manpages get compressed as part of rpmbuild, and compressed
data isn't properly versioned in git

doc/CMakeLists.txt
doc/createrepo_c.8 [new file with mode: 0644]
doc/createrepo_c.8.gz [deleted file]
doc/mergerepo_c.8 [new file with mode: 0644]
doc/mergerepo_c.8.gz [deleted file]
doc/modifyrepo_c.8 [new file with mode: 0644]
doc/modifyrepo_c.8.gz [deleted file]
doc/sqliterepo_c.8 [new file with mode: 0644]
doc/sqliterepo_c.8.gz [deleted file]

index b4dd4cb25d48eac5e2eb9b10c5e19046e0e7a2cd..e59946cd55fcc499aa44e1b21ab63fca69443f36 100644 (file)
@@ -8,7 +8,7 @@ if(DOXYGEN_FOUND)
         COMMENT "Building C API documentation with Doxygen" VERBATIM)
 endif(DOXYGEN_FOUND)
 
-INSTALL(FILES createrepo_c.8.gz mergerepo_c.8.gz modifyrepo_c.8.gz sqliterepo_c.8.gz
+INSTALL(FILES createrepo_c.8 mergerepo_c.8 modifyrepo_c.8 sqliterepo_c.8
         DESTINATION share/man/man8
         COMPONENT bin)
 
diff --git a/doc/createrepo_c.8 b/doc/createrepo_c.8
new file mode 100644 (file)
index 0000000..cc03536
--- /dev/null
@@ -0,0 +1,166 @@
+.\" Man page generated from reStructuredText.
+.
+.TH CREATEREPO_C  "2015-05-25" "" ""
+.SH NAME
+createrepo_c \- Create rpm-md format (xml-rpm-metadata) repository
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.\" -*- coding: utf-8 -*-
+.
+.SH SYNOPSIS
+.sp
+createrepo_c [options] <directory>
+.SH OPTIONS
+.SS \-V \-\-version
+.sp
+Show program\(aqs version number and exit.
+.SS \-q \-\-quiet
+.sp
+Run quietly.
+.SS \-v \-\-verbose
+.sp
+Run verbosely.
+.SS \-x \-\-excludes <packages>
+.sp
+File globs to exclude, can be specified multiple times.
+.SS \-\-basedir <basedir>
+.sp
+Basedir for path to directories.
+.SS \-u \-\-baseurl <URL>
+.sp
+Optional base URL location for all files.
+.SS \-g \-\-groupfile GROUPFILE
+.sp
+Path to groupfile to include in metadata.
+.SS \-s \-\-checksum <checksum_type>
+.sp
+Choose the checksum type used in repomd.xml and for packages in the metadata. The default is now sha256.
+.SS \-p \-\-pretty
+.sp
+Make sure all xml generated is formatted (default)
+.SS \-d \-\-database
+.sp
+Generate sqlite databases for use with yum.
+.SS \-\-no\-database
+.sp
+Do not generate sqlite databases in the repository.
+.SS \-\-update
+.sp
+If metadata already exists in the outputdir and an rpm is unchanged (based on file size and mtime) since the metadata was generated, reuse the existing metadata rather than recalculating it. In the case of a large repository with only a few new or modified rpms this can significantly reduce I/O and processing time.
+.SS \-\-update\-md\-path
+.sp
+Use the existing repodata for \-\-update from this path.
+.SS \-\-skip\-stat
+.sp
+Skip the stat() call on a \-\-update, assumes if the filename is the same then the file is still the same (only use this if you\(aqre fairly trusting or gullible).
+.SS \-i \-\-pkglist <filename>
+.sp
+Specify a text file which contains the complete list of files to include in the repository from the set found in the directory. File format is one package per line, no wildcards or globs.
+.SS \-n \-\-includepkg <packages>
+.sp
+Specify pkgs to include on the command line. Takes urls as well as local paths.
+.SS \-o \-\-outputdir <URL>
+.sp
+Optional output directory.
+.SS \-S \-\-skip\-symlinks
+.sp
+Ignore symlinks of packages.
+.SS \-\-changelog\-limit <number>
+.sp
+Only import the last N changelog entries, from each rpm, into the metadata.
+.SS \-\-unique\-md\-filenames
+.sp
+Include the file\(aqs checksum in the metadata filename, helps HTTP caching (default).
+.SS \-\-simple\-md\-filenames
+.sp
+Do not include the file\(aqs checksum in the metadata filename.
+.SS \-\-retain\-old\-md <N>
+.sp
+Keep around the latest (by timestamp) N copies of the old repodata.
+.SS \-\-distro DISTRO
+.sp
+Distro tag and optional cpeid: \-\-distro\(aqcpeid,textname\(aq.
+.SS \-\-content CONTENT_TAGS
+.sp
+Tags for the content in the repository.
+.SS \-\-repo REPO_TAGS
+.sp
+Tags to describe the repository itself.
+.SS \-\-revision REVISION
+.sp
+User\-specified revision for this repository.
+.SS \-\-read\-pkgs\-list READ_PKGS_LIST
+.sp
+Output the paths to the pkgs actually read useful with \-\-update.
+.SS \-\-workers
+.sp
+Number of workers to spawn to read rpms.
+.SS \-\-xz
+.sp
+Use xz for repodata compression.
+.SS \-\-compress\-type <compress_type>
+.sp
+Which compression type to use.
+.SS \-\-keep\-all\-metadata
+.sp
+Keep groupfile and updateinfo from source repo during update.
+.SS \-\-compatibility
+.sp
+Enforce maximal compatibility with classical createrepo.
+.SS \-\-retain\-old\-md\-by\-age AGE
+.sp
+During \-\-update, remove all files in repodata/ which are older then the specified period of time. (e.g. \(aq2h\(aq, \(aq30d\(aq, ...). Available units (m \- minutes, h \- hours, d \- days)
+.SS \-c \-\-cachedir CACHEDIR.
+.sp
+Set path to cache dir
+.SS \-\-deltas
+.sp
+Tells createrepo to generate deltarpms and the delta metadata.
+.SS \-\-oldpackagedirs PATH
+.sp
+Paths to look for older pkgs to delta against. Can be specified multiple times.
+.SS \-\-num\-deltas INT
+.sp
+The number of older versions to make deltas against. Defaults to 1.
+.SS \-\-max\-delta\-rpm\-size MAX_DELTA_RPM_SIZE
+.sp
+Max size of an rpm that to run deltarpm against (in bytes).
+.SS \-\-local\-sqlite
+.sp
+Gen sqlite DBs locally (into a directory for temporary files). Sometimes, sqlite has a trouble to gen DBs on a NFS mount, use this option in such cases. This option could lead to a higher memory consumption if TMPDIR is set to /tmp or not set at all, because then the /tmp is used and /tmp dir is often a ramdisk.
+.SS \-\-cut\-dirs NUM
+.sp
+Ignore NUM of directory components in location_href during repodata generation
+.SS \-\-location\-prefix PREFIX
+.sp
+Append this prefix before location_href in output repodata
+.SS \-\-ignore\-lock
+.sp
+Expert (risky) option: Ignore an existing .repodata/. (Remove the existing .repodata/ and create an empty new one to serve as a lock for other createrepo intances. For the repodata generation, a different temporary dir with the name in format .repodata.time.microseconds.pid/ will be used). NOTE: Use this option on your own risk! If two createrepos run simultaneously, then the state of the generated metadata is not guaranted \- it can be inconsistent and wrong.
+.\" Generated by docutils manpage writer.
+.
diff --git a/doc/createrepo_c.8.gz b/doc/createrepo_c.8.gz
deleted file mode 100644 (file)
index d7efbdd..0000000
Binary files a/doc/createrepo_c.8.gz and /dev/null differ
diff --git a/doc/mergerepo_c.8 b/doc/mergerepo_c.8
new file mode 100644 (file)
index 0000000..e44431a
--- /dev/null
@@ -0,0 +1,91 @@
+.\" Man page generated from reStructuredText.
+.
+.TH MERGEREPO_C  "2015-05-25" "" ""
+.SH NAME
+mergerepo_c \- Merge multiple rpm-md format repositories together
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.\" -*- coding: utf-8 -*-
+.
+.SH SYNOPSIS
+.sp
+mergerepo_c [options] \-\-repo repo1 \-\-repo repo2
+.SH OPTIONS
+.SS \-\-version
+.sp
+Show program\(aqs version number and exit
+.SS \-r \-\-repo REPOS
+.sp
+Repo url
+.SS \-a \-\-archlist ARCHLIST
+.sp
+Defaults to all arches \- otherwise specify arches
+.SS \-d \-\-database
+.SS \-\-no\-database
+.SS \-v \-\-verbose
+.SS \-o \-\-outputdir OUTPUTDIR
+.sp
+Location to create the repository
+.SS \-\-nogroups
+.sp
+Do not merge group (comps) metadata
+.SS \-\-noupdateinfo
+.sp
+Do not merge updateinfo metadata
+.SS \-\-compress\-type COMPRESS_TYPE
+.sp
+Which compression type to use
+.SS \-\-method MERGE_METHOD
+.sp
+Specify merge method for packages with the same name and arch (available merge methods: repo (default), ts, nvr)
+.SS \-\-all
+.sp
+Include all packages with the same name and arch if version or release is different. If used \-\-method argument is ignored!
+.SS \-\-noarch\-repo URL
+.sp
+Packages with noarch architecture will be replaced by package from this repo if exists in it.
+.SS \-\-unique\-md\-filenames
+.sp
+Include the file\(aqs checksum in the metadata filename, helps HTTP caching (default).
+.SS \-\-simple\-md\-filenames
+.sp
+Do not include the file\(aqs checksum in the metadata filename.
+.SS \-\-omit\-baseurl
+.sp
+Don\(aqt add a baseurl to packages that don\(aqt have one before.
+.SS \-k \-\-koji
+.sp
+Enable koji mergerepos behaviour.
+.SS \-g \-\-groupfile GROUPFILE
+.sp
+Path to groupfile to include in metadata.
+.SS \-b \-\-blocked FILE
+.sp
+A file containing a list of srpm names to exclude from the merged repo. Only works with combination with \-\-koji/\-k.
+.\" Generated by docutils manpage writer.
+.
diff --git a/doc/mergerepo_c.8.gz b/doc/mergerepo_c.8.gz
deleted file mode 100644 (file)
index 5700f1c..0000000
Binary files a/doc/mergerepo_c.8.gz and /dev/null differ
diff --git a/doc/modifyrepo_c.8 b/doc/modifyrepo_c.8
new file mode 100644 (file)
index 0000000..6a3e9c1
--- /dev/null
@@ -0,0 +1,80 @@
+.\" Man page generated from reStructuredText.
+.
+.TH MODIFYREPO_C  "2015-05-25" "" ""
+.SH NAME
+modifyrepo_c \- Modify a repomd.xml of rpm-md format repository
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.\" -*- coding: utf-8 -*-
+.
+.SH SYNOPSIS
+.sp
+modifyrepo_c [options] <input metadata> <output repodata>
+.sp
+modifyrepo_c \-\-remove <metadata type> <output repodata>
+.sp
+modifyrepo_c [options] \-\-batchfile <batch file> <output repodata>
+.SH OPTIONS
+.SS \-\-version
+.sp
+Show program\(aqs version number and exit.
+.SS \-\-mdtype MDTYPE
+.sp
+Specific datatype of the metadata, will be derived from the filename if not specified.
+.SS \-\-remove
+.sp
+Remove specified file from repodata.
+.SS \-\-compress
+.sp
+Compress the new repodata before adding it to the repo. (default)
+.SS \-\-no\-compress
+.sp
+Do not compress the new repodata before adding it to the repo.
+.SS \-\-compress\-type COMPRESS_TYPE
+.sp
+Compression format to use.
+.SS \-s \-\-checksum SUMTYPE
+.sp
+Specify the checksum type to use. (default: sha256)
+.SS \-\-unique\-md\-filenames
+.sp
+Include the file\(aqs checksum in the filename, helps with proxies. (default)
+.SS \-\-simple\-md\-filenames
+.sp
+Do not include the file\(aqs checksum in the filename.
+.SS \-\-verbose
+.sp
+Verbose output.
+.SS \-f \-\-batchfile BATCHFILE
+.sp
+Batch file.
+.SS \-\-new\-name NEWFILENAME
+.sp
+New filename for the file
+.\" Generated by docutils manpage writer.
+.
diff --git a/doc/modifyrepo_c.8.gz b/doc/modifyrepo_c.8.gz
deleted file mode 100644 (file)
index 00afe03..0000000
Binary files a/doc/modifyrepo_c.8.gz and /dev/null differ
diff --git a/doc/sqliterepo_c.8 b/doc/sqliterepo_c.8
new file mode 100644 (file)
index 0000000..7688153
--- /dev/null
@@ -0,0 +1,67 @@
+.\" Man page generated from reStructuredText.
+.
+.TH SQLITEREPO_C  "2015-05-25" "" ""
+.SH NAME
+sqliterepo_c \- Generate sqlite db files for a repository in rpm-md format
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.\" -*- coding: utf-8 -*-
+.
+.SH SYNOPSIS
+.sp
+sqliterepo_c [options] <repo_directory>
+.SH OPTIONS
+.SS \-V \-\-version
+.sp
+Show program\(aqs version number and exit.
+.SS \-q \-\-quiet
+.sp
+Run quietly.
+.SS \-v \-\-verbose
+.sp
+Run verbosely.
+.SS \-f \-\-force
+.sp
+Overwirte existing DBs.
+.SS \-\-keep\-old
+.sp
+Do not remove old DBs. Use only with combination with \-\-force.
+.SS \-\-xz
+.sp
+Use xz for repodata compression.
+.SS \-\-compress\-type <compress_type>
+.sp
+Which compression type to use.
+.SS \-\-checksum <checksum_type>
+.sp
+Which checksum type to use in repomd.xml for sqlite DBs.
+.SS \-\-local\-sqlite
+.sp
+Gen sqlite DBs locally (into a directory for temporary files). Sometimes, sqlite has a trouble to gen DBs on a NFS mount, use this option in such cases. This option could lead to a higher memory consumption if TMPDIR is set to /tmp or not set at all, because then the /tmp is used and /tmp dir is often a ramdisk.
+.\" Generated by docutils manpage writer.
+.
diff --git a/doc/sqliterepo_c.8.gz b/doc/sqliterepo_c.8.gz
deleted file mode 100644 (file)
index 325717f..0000000
Binary files a/doc/sqliterepo_c.8.gz and /dev/null differ