summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAge
...
* doc: rename manlink macro to linkmanDan McGee2007-12-29
| | | | | | | | | | | | | | | | | | | | | | | | | Between AsciiDoc 8.2.2 and 8.2.3, the following change was made to the stock Asciidoc configuration: @@ -149,7 +153,10 @@ # Inline macros. # Backslash prefix required for escape processing. # (?s) re flag for line spanning. -(?su)[\\]?(?P<name>\w(\w|-)*?):(?P<target>\S*?)(\[(?P<attrlist>.*?)\])= + +# Explicit so they can be nested. +(?su)[\\]?(?P<name>(http|https|ftp|file|mailto|callto|image|link)):(?P<target>\S*?)(\[(?P<attrlist>.*?)\])= + # Anchor: [[[id]]]. Bibliographic anchor. (?su)[\\]?\[\[\[(?P<attrlist>[\w][\w-]*?)\]\]\]=anchor3 # Anchor: [[id,xreflabel]] This default regex now matches explicit values, and unfortunately in this case manlink was being matched by just 'link', causing the wrong inline macro template to be applied. By renaming the macro, we can avoid being matched by the wrong regex. Signed-off-by: Dan McGee <dan@archlinux.org>
* Ensure that manpages are always distributed and installedDan McGee2007-12-28
| | | | | | | | | | | | | Commit 012f7939784358b02726c169543aa99436439335 was a bit misguided in its thinking, and resulted in a package built without asciidoc enabled not installing the manpages to the system on a 'make install' operation. Fix this behavior by making manpages required in a normal build, and in order to disable their existence, the '--disable-doc' option must be used. Hopefully this solves manpage issues for both developers and package builders while allowing as much flexibility as possible. Signed-off-by: Dan McGee <dan@archlinux.org>
* Update PKGBUILD manpage to give info on scriptlet argumentsDan McGee2007-12-19
| | | | Signed-off-by: Dan McGee <dan@archlinux.org>
* Add PM_DEP_MOD_GT and PM_DEP_MOD_LT to documentationNagy Gabor2007-12-19
| | | | | Signed-off-by: Nagy Gabor <ngaba@bibl.u-szeged.hu> Signed-off-by: Dan McGee <dan@archlinux.org>
* Updates to PKGBUILD manpageDan McGee2007-12-10
| | | | | | | | Make the manpage a little more distro agnostic by referring to ABS in the context of Arch Linux, and saying that prototype files are also available with the pacman source. Signed-off-by: Dan McGee <dan@archlinux.org>
* Update pacman manpage with description of --clean optionDan McGee2007-12-05
| | | | Signed-off-by: Dan McGee <dan@archlinux.org>
* Add new --needed option for -S.Chantry Xavier2007-12-02
| | | | | | | | | | | | | | | | | During a pacman operation such as a group install, pacman can ask several questions such as "local version is up to date. Upgrade anyway?". They are usually all answered either by yes or by no: * yes when you want to reinstall all the targets. * no when you only want to install the missing ones (either because you are installing a group, or because you are copying a pacman -S line from wiki or whatever). So instead of asking this question for each target, it is now now configured with a flag. Yes will be the default -S behavior, No will be achieved with the --needed flag. Signed-off-by: Chantry Xavier <shiningxc@gmail.com> Signed-off-by: Dan McGee <dan@archlinux.org>
* Remove -F/--freshen operationDan McGee2007-11-21
| | | | | | | | | | This operation made sense in the days before sync DBs existed, but it no longer has the same usefulness it once did. Signed-off-by: Dan McGee <dan@archlinux.org> Signed-off-by: Chantry Xavier <shiningxc@gmail.com> Signed-off-by: Nagy Gabor <ngaba@bibl.u-szeged.hu> Signed-off-by: Aaron Griffin <aaronmgriffin@gmail.com>
* doc: use source highlighter on PKGBUILD guide, update wrong example textDan McGee2007-11-20
| | | | | | | Note that if you are building manpages with asciidoc now, you must also have source-highlight installed for it to correctly generate everything. Signed-off-by: Dan McGee <dan@archlinux.org>
* Update PKGBUILD manpage with versioned conflicts.Chantry Xavier2007-11-20
| | | | | | | | | As the b96922679e4ed14aa687bf194b766d82a1d10577 commit showed with two pactests (which were renamed to depconflict110/111), versioned conflicts are now possible. Signed-off-by: Chantry Xavier <shiningxc@gmail.com> Signed-off-by: Dan McGee <dan@archlinux.org>
* Versioned provisions.Nagy Gabor2007-11-18
| | | | | | | | | | | | | | | | | | | This patch introduces versioned provisions in "provision 1.0-1" format. _alpm_db_whatprovides was modified accordingly (added sync500.py), alpm_depcmp was modified accordingly (add043.py passes now; added add044.py and add045.py). Notes: alpm_db_search now uses the whole versioned %PROVIDES% string in its search. debug logging was simplified in alpm_depcmp. Signed-off-by: Nagy Gabor <ngaba@bibl.u-szeged.hu> [Xavier: fixed a few typos, duplicate const strings with strdup before modifying them, put some debugging back in alpm_depcmp, minor code cleanups (var/function renaming), added a note in PKGBUILD man page.] Signed-off-by: Chantry Xavier <shiningxc@gmail.com> [Dan: made strcmp checks clearer, added a comment] Signed-off-by: Dan McGee <dan@archlinux.org>
* Make it easier to ignore multiple packages.Nathan Jones2007-11-13
| | | | | | | | | | | | This makes --ignore and --ignoregroup able to accept multiple packages/groups by separating each with a comma. For instance: pacman -Su --ignore kernel26,udev,glibc This was requested in the comments of FS#8054. Signed-off-by: Nathan Jones <nathanj@insightbb.com> Signed-off-by: Dan McGee <dan@archlinux.org>
* Add help for --ignoregroup.Nathan Jones2007-11-13
| | | | | | Signed-off-by: Nathan Jones <nathanj@insightbb.com> [Dan: split usage line into two lines for clarity] Signed-off-by: Dan McGee <dan@archlinux.org>
* configure: Doxygen is disabled by default; manpages are included in distDan McGee2007-11-13
| | | | Signed-off-by: Dan McGee <dan@archlinux.org>
* Add TotalDownload option.Nathan Jones2007-11-11
| | | | | | | This will be used in the next commit. Signed-off-by: Nathan Jones <nathanj@insightbb.com> Signed-off-by: Dan McGee <dan@archlinux.org>
* Add IgnoreGroup and --ignoregroup option.Nathan Jones2007-11-11
| | | | | | | This will be used in the next commit. Signed-off-by: Nathan Jones <nathanj@insightbb.com> Signed-off-by: Dan McGee <dan@archlinux.org>
* Small manpage updatesDan McGee2007-11-08
| | | | Signed-off-by: Dan McGee <dan@archlinux.org>
* Get rid of the footnotes section in generated manpagesDan McGee2007-11-08
| | | | | | | We really don't need it since it is just links. However, we do need to figure out how to get our old links to show up right. Signed-off-by: Dan McGee <dan@archlinux.org>
* doc: update links in footer.txt so they are actual linksDan McGee2007-11-08
| | | | Signed-off-by: Dan McGee <dan@archlinux.org>
* Update PKGBUILD.5 with missing devel variable descriptionsDan McGee2007-11-08
| | | | | | | The lack of descriptions on some of the variables was causing issues with documentation generation. Adding text to them fixes this. Signed-off-by: Dan McGee <dan@archlinux.org>
* Sync asciidoc.conf with GIT repository changesDan McGee2007-11-08
| | | | | | We got our file from the GIT repository originally, so keep it up to date. Signed-off-by: Dan McGee <dan@archlinux.org>
* Update the PKGBUILD example in the manpagesDan McGee2007-11-07
| | | | | | | The old one was old. Use something a bit more recent and a bit simpler as well so it actually looks OK in the manpage. Signed-off-by: Dan McGee <dan@archlinux.org>
* Small updates to documentation.Scott Horowitz2007-10-29
| | | | | Signed-off-by: Scott Horowitz <stonecrest@gmail.com> Signed-off-by: Dan McGee <dan@archlinux.org>
* doxygen: preprocess SYMHIDDEN/SYMEXPORT macros so they don't show in docsDan McGee2007-10-29
| | | | Signed-off-by: Dan McGee <dan@archlinux.org>
* Download delta files if UseDelta is set.Nathan Jones2007-10-19
| | | | | | | | Delta files will be used if the size is smaller than a percent (MAX_DELTA_RATIO) of the package size. Signed-off-by: Nathan Jones <nathanj@insightbb.com> Signed-off-by: Dan McGee <dan@archlinux.org>
* Updates to fix Doxygen documentation generationDan McGee2007-10-14
| | | | | | | | | We had way too much going on with the Doxygen manpage generation. Clean it up quite a bit by removing directory manpages, using relative paths, not having a manpage for every single alpm function, and ensuring internal functions are not documented publicly. Signed-off-by: Dan McGee <dan@archlinux.org>
* document the -Qii option.Chantry Xavier2007-09-27
| | | | | | | | | I suppose -Qii could be used for other things than displaying the list of backup files, but currently, it's the only one, so that's how I documented it.. Signed-off-by: Chantry Xavier <shiningxc@gmail.com> Signed-off-by: Dan McGee <dan@archlinux.org>
* Allow a normal 'make' to compile without asciidoc installedDan McGee2007-09-23
| | | | | | | | If we don't have asciidoc installed or enabled, we should still have a successful make. However, we want to ensure 'make dist' fails without asciidoc. This commit should ensure this. Signed-off-by: Dan McGee <dan@archlinux.org>
* Update NEWS, -S testing/qt example, and mirrorlist changeDan McGee2007-09-18
| | | | Signed-off-by: Dan McGee <dan@archlinux.org>
* Refine pacman manpage, clarify -S repo/package possibility, remove --testDan McGee2007-09-17
| | | | Signed-off-by: Dan McGee <dan@archlinux.org>
* Merge branch 'asciidoc' into workingDan McGee2007-09-16
|\ | | | | | | | | We're getting close to release, so might as well do this now so people can actually update some of our documentation.
| * Update manpage with new query options.Chantry Xavier2007-08-16
| | | | | | | | | | | | | | Dan: did a bit more updating and clarifying. Signed-off-by: Chantry Xavier <shiningxc@gmail.com> Signed-off-by: Dan McGee <dan@archlinux.org>
| * Man page revision timeDan McGee2007-07-16
| | | | | | | | | | | | | | | | | | | | Spruce up the asciidoc formatting, fix a few issues that we had. Formatting now looks pretty good in both the manpage output and the XHTML output. Also added some options that we have changed since 3.0, and a few wording updates, etc. Signed-off-by: Dan McGee <dan@archlinux.org>
| * Add asciidoc checking to configure.ac, make manpage generation optionalDan McGee2007-07-09
| | | | | | | | | | | | | | | | | | Include manpages when we ship a package tarball, and allow them to be generated by the end user if they want by using the --enable-asciidoc option to ./configure. This will allow us to maintain manpages in an easier to modify format while still keeping the make dependencies to a minimum. Signed-off-by: Dan McGee <dan@archlinux.org>
| * Add a manpage for repo-addDan McGee2007-07-09
| | | | | | | | | | | | | | | | We still need some work here- we should have a repo-remove manpage link to this one, and we should not have to struggle with asciidoc formatting to get it to work like any other multiple-command manpage works. Signed-off-by: Dan McGee <dan@archlinux.org>
| * Asciidoc updates- make it pretty, fix build, etc.Dan McGee2007-07-09
| | | | | | | | | | | | | | | | | | | | | | | | * Fix up the target so we rebuild the manpages when we edit the corresponding text file. * Add vim modelines to all of the asciidoc files ensureing the right syntax highlighting is used and we have expandtabs turned off. * Start making a few small changes to PKGBUILD.5 to make it pretty in both HTML and manpage format output. * Fix the manlink macro to include the manpage section in the link. Signed-off-by: Dan McGee <dan@archlinux.org>
| * Update PKGBUILD example.Andrew Fyfe2007-07-09
| | | | | | | | Signed-off-by: Andrew Fyfe <andrew@neptune-one.net>
| * Add Synopsis section to man 5 pages.Andrew Fyfe2007-07-09
| | | | | | | | Signed-off-by: Andrew Fyfe <andrew@neptune-one.net>
| * Make manpage generation depend on footer.txtDan McGee2007-07-09
| | | | | | | | | | | | | | If footer.txt is updated, we need to regenerate the manpages, this little fix should do this. Signed-off-by: Dan McGee <dan@archlinux.org>
| * doc/Makefile.am: Set pacman version and date when man pages are generated.Andrew Fyfe2007-07-09
| | | | | | | | Signed-off-by: Andrew Fyfe <andrew@neptune-one.net>
| * Convert the remaining man pages to asciidoc.Andrew Fyfe2007-07-09
| | | | | | | | Signed-off-by: Andrew Fyfe <andrew@neptune-one.net>
| * Move common stuff into footer.txt and some formating tweaks.Andrew Fyfe2007-07-09
| | | | | | | | Signed-off-by: Andrew Fyfe <andrew@neptune-one.net>
| * Add two asciidoc manpages to the doc/ dirAndrew Fyfe2007-07-09
| | | | | | | | | | | | | | Add the pacman.8 and pacman.conf.5 asciidoc manpages to the GIT tree, with the rest to follow. Signed-off-by: Dan McGee <dan@archlinux.org>
| * Start addition of asciidoc stuffDan McGee2007-07-09
| | | | | | | | | | | | | | | | Add some asciidoc generation stuff to the doc/ Makefile.am so we can get some manpages up and working. Add necessary stuff to gitignore, and check in the asciidoc.conf file along with the footer for all of the manpages. Signed-off-by: Dan McGee <dan@archlinux.org>
| * Remove old 'static' manpages in anticipation of the asciidoc switchDan McGee2007-07-09
| | | | | | | | Signed-off-by: Dan McGee <dan@archlinux.org>
* | Remove the DB consistency check from pacman and libalpm.Chantry Xavier2007-09-16
| | | | | | | | | | | | | | | | | | | | | | | | This reverts commit dfc85cb5f516ffbcff557522e9703c5c7d88b047 and b6f3fe6957d0206485eac98fb2120578b75d0058. This DB check is already in testdb (among others). Also testdb now uses the db path set at make time by default, so specifying the db path is optional. Signed-off-by: Chantry Xavier <shiningxc@gmail.com> Signed-off-by: Dan McGee <dan@archlinux.org>
* | Remove unnecessary entries from .gitignore filesDan McGee2007-07-16
|/ | | | | | | .gitignore works recursively, so we don't need Makefile and Makefile.in in all of the subdirectory .gitignore files. Signed-off-by: Dan McGee <dan@archlinux.org>
* Move Doxygen manpage generation to doc/ directoryDan McGee2007-07-01
| | | | | | | Instead of doing the doxygen work in the libalpm/ dir, do it with the rest of the docs in the doc/ dir. Signed-off-by: Dan McGee <dan@archlinux.org>
* Implement a -Qt operation in frontend to test the databaseDan McGee2007-06-09
| | | | | | | | After adding a alpm_db_check() operation in the back end, we can call it in the front end and present a user-friendly interface to it. Inspired-by: VMiklos <vmiklos@frugalware.org> Signed-off-by: Dan McGee <dan@archlinux.org>
* Autotool clean up.Andrew Fyfe2007-06-04
| | | | | | | | | * Add vim modeline to Makefile.am and configure.ac * Fix white space in Makefile.am and configure.ac * Add contrib/wget-xdelta.sh to EXTRA_DIST in Makefile.am Signed-off-by: Andrew Fyfe <andrew@neptune-one.net> Signed-off-by: Dan McGee <dan@archlinux.org>