summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2012-07-12Bump version to 0.6.9.1HEADmasterDaniel Hartwig1-1/+1
2012-07-05French documentation translation updateChristian PERRIER2-3585/+4306
Closes: #680040
2012-06-28Update Polish translationMichał Kułach1-39/+6
Closes: #678153
2012-06-28?architecture supports arch specification strings, wildcardsDaniel Hartwig1-0/+12
See Debian Policy § 11.1 for more info.
2012-06-20Do not do FixMissing automatically for command-line actionsDaniel Hartwig2-0/+42
When a package is not available or fails to download incorrectly aptitude would try to continue without it. This made it hard to detect errors automatically using the exit status. This behaviour is no longer the default, instead if there are missing packages an error will be displayed and the program exit with failure (100). If the user wishes to continue anyway, they can use --fix-missing or configure Aptitude::CmdLine::Fix-Missing in apt.conf. * [cmdline]: An install run will no longer proceed if any package was unavailable or failed to download correctly, instead an error will be shown and exit with non-zero status (100). (Closes: #121313, #302784) The old behaviour can be obtained with the new --fix-missing option or setting Aptitude::CmdLine::Fix-Missing. Closes: #121313 Closes: #302784
2012-06-20Tidy error handling in main, cmdline actionsDaniel Hartwig1-0/+47
Error conditions are much stricter, detecting errors is more reliable, and the exit status of all command-line actions is well-defined. All commands will return one of these values as their exit status: 0 – success 1 – user aborted (install, remove, …); or no matches (search, why, why-not); 100 – failure For commands whose arguments are lists of packages or search patterns the following general conditions hold: It is a failure if any package argument does not exactly name a package. It is a failure if any versioned argument requests a version which is not available for every package identified by that argument. Versioned arguments are those which end with a version or archive (release) specifier, respectively “=<version>” and “/<archive>”. If a command includes a request to install, remove, or purge any package that command will not proceed if any of the above failures occur. Other commands may still proceed in case of such failures but will exit with non-zero status to indicate they were not completely effective. Some commands have exceptions and/or extensions to the general conditions: install, upgrade, remove, …: Where a request specifies a virtual package it is a failure if it has either no provider or multiple providers. If there is only one provider that package will be selected instead of the virtual package. search: All arguments are considered patterns. Arguments without an explicit search term will be wrapped in an implicit ‘?name’ term. This is a major change from previous versions where the program would have proceeded and possibly exited with a status indicating success (0) despite some requested actions being either invalid or ineffective. The new, stricter behaviour is desirable for two reasons: - to prevent the situation where a request to replace one set of packages with another set proceeds when (some of) the replacements are not found or unavailable could cause the undesired removal of arbitrary other packages; - to make the program more atomic and reliable when used for automated tasks – by considering the entire request as being essential to success another program can rely on an exit status of 0 to mean that the request was completely carried out. Summary of changes: * Most errors are now displayed at the end of a command's output which makes them easier to spot when there is lots of output. (Closes: #430392) * [cmdline]: Virtual packages which have an already installed provider are only skipped when the requested action is to install them. * [cmdline]: install and similar actions have much stronger error checking and will exit more reliably with non-zero status on failures Failures which result in no action and a non-zero exit status (100): - a package argument does not exactly name an available package; - a versioned argument requests a version which is not available for every package it applies to (Closes: #590686); * [cmdline]: changelog exits with non-zero status on any error (Closes: #675833) * [cmdline]: search exit with status 1 if it found no matches (Closes: #497299) * [cmdline]: why exits with status 1 if it found no reasons given the particular arguments * [cmdline]: show will exit with status 100 if it found no packages or a named package was not found * unknown arguments do not show the usage screen * more errors are reported using GlobalError * clean up some strings used as error messages * download_install_manager.cc: - repeat if package manager result is DoAgain; - report all download errors not just the first; * cmdline_util.cc: - pkgset_from_string by default is no longer an error if a pattern matches no packages * [doc]: add section on exit status to the man page Closes: #430392 Closes: #497299 Closes: #590686 Closes: #675833
2012-06-16Use apt's CommandLine parserDaniel Hartwig2-5/+36
Previously aptitude was using it's own command line parser implemented on top of getopt. Replacing this with the standard apt class means there are no longer subtle quirks with our parser (such as "-qq" not being valid, when it is fine for other apt programs). The parser is closely tied to the Configuration, and reads options directly in to the global apt config. Some options were tracked independently of the global config; this change is the first part rectifying that situation. The goal is to keep all program options, configuration state, etc. in the global config rather than passing state variables between functions. Many options which previously did not have an associated configuration item now do; some remain undocumented for now as they are transitional. * handle "-qq" like other apt-utils * properly process all -o command line options (Closes: #587671) * unknown command line options trigger an error (Closes: #434502) * --add-user-tag-to, --remove-user-tag-from are working; no bug reports suggests that noone has noticed they were broken New aliases for some command-line options: --yes, for --assume-yes (apt-get) --default-release, for --target-release (apt-utils) --install-on-startup, for -i --update-on-startup, for -u New configuration item: Aptitude::CmdLine::Sorting, equivalent to --sort Other new configuration items are for internal use only at this point. Closes: #587671 Closes: #434502
2012-06-08Update build files for 0.6.9Daniel Hartwig1-1/+1
2012-06-04Temporary fix to install man pages: specify targets manuallyDaniel Hartwig10-1/+31
2012-06-03Include manual translations in .gitignoreDaniel Hartwig1-2/+7
2012-06-03Update .gitignore for doc buildlibDaniel Hartwig1-0/+30
2012-06-03Update doc po filesDaniel Hartwig8-187/+99
2012-06-03DOCBOOK_HTML_XSL contains all xsl dependenciesDaniel Hartwig2-2/+5
2012-06-02README.en → READMEDaniel Hartwig1-1/+1
- was mistakenly renamed during the doc buildlib update
2012-06-02Include documentation and template for new doc buildlib systemDaniel Hartwig2-1/+47
2012-06-01Tweak targets, variables in doc MakefilesDaniel Hartwig11-16/+12
2012-06-01Fix minor groff error in other manpagesDaniel Hartwig10-40/+34
<refmeta> elements which used the &aptitude; (and other) entities were exported with implicit <command> elements. These inserted font change tags which were upcased in the output file, generating an unknown font warning.
2012-06-01Update to the doc buildlib; all translations portedDaniel Hartwig18-551/+129
All doc translations now use the new buildlib rule files which is cleaner and much easier to maintain. This involves many changes and a general cleanup. Some of the more noticable changes: * doc: - html docs no longer install to $docdir/html, but respect the htmldir option of configure (which defaults to $docdir) - build is more parallel * buildlib/doc.mk: - Standard makefile rules for documentation * buildlib/docbook.mk: - Makefile rules for targets from docbook source * buildlib/po4a.mk: - Makefile rules for targets from po4a translations * doc/Makefile.am, doc/??/Makefile.am: - rename LANGCODE to LC - update to use buildlib files; most of these files are now very short * configure.ac: - suppress portability warnings as we require GNU make - include bugreport address - check for tools used to generate the documentation: po4a, xsltproc, fop, rsvg-convert
2012-05-31Tidy generation, encoding of README filesDaniel Hartwig13-67/+29
Encoding issues are now taken care of by html-to-text. No longer are there "ASCII" hacks in stylesheets and such. Some READMEs were available but not installed. Even though some of these are older translations they are now all installed to the system. * doc/aptitude-txt.xsl: - removed ASCII hacks which did not work * doc/fixup-text: - removed this script, no longer needed * doc/html-to-text: - now takes mandatory output encoding argument * explicitly set encodings - README.en → ISO-8859-1 - README.{cs,es,fr,fi,it,ja} → UTF-8 * po/*.po: - updated for these changes - clear incorrect msgstr where the translator had mistaken the purpose of "README"
2012-05-31Small bug in doc/it/images/Makefile.amDaniel Hartwig1-1/+1
2012-05-31Fix groff warning in manpageDaniel Hartwig1-2/+2
Closes: #675085
2012-05-30Italian translation of safety-cost-level-diagram.svgDaniel Hartwig2-19/+18
2012-05-30Update doc po filesDaniel Hartwig7-8635/+8785
2012-05-30Remove redundancy in doc build systemDaniel Hartwig11-596/+137
Lots of code was duplicated between makefiles for the various translations. Much of this is now in common rules files making it easier to add new translations. Translations that use po4a and provide full documentation have been updated to use the new includes. Some work is still required to make this compatible with the non-po4a and partial translations. * doc/common.mk: - common rules for doc makefiles * doc/po4a.mk: - common rules for po4a makefiles * doc/po4a/po4a.cfg: - new po files are picked up automatically - translate also safety-cost-level-diagram.svg * doc/po4a/Makefile.am: - update-po only updates the po files * doc/po4a/po/Makefile.am: - include aptitude.pot in dist files * doc/{es,fr,it}/Makefile.am: - use common rules
2012-05-28Fix minor errors in documentBeatrice Torracca2-4/+5
* doc/en/aptitude.xml: - 2 instances of the command "versions" mispelled as "version" * doc/en/manpage.xml: - an error in the explanation of the dependency resolver costs: 2*removals + 3*upgrades should mean that three removals (2*3) equals 2 upgrades (3*2). Closes: #674675
2012-05-28Integrate Italian docs with build systemDaniel Hartwig5-3/+96
2012-05-27Italian translation of documentationChristian PERRIER31-1/+25084
2012-05-23Update docs for localized column widthsDaniel Hartwig3-11/+11
2012-05-11Add doctype headers to html docs.Daniel Hartwig1-0/+4
2012-05-11Update build files for 0.6.8.Daniel Hartwig1-1/+1
2012-04-27Do not call debtags on list update.Daniel Hartwig1-32/+0
This was a rather unsightly kludge and is better suited as a script for APT::Update::Post-Invoke.
2012-04-25update Finnish manpage to point to doc package (from Ubuntu: ↵Daniel Hartwig1-1/+1
12_point_manpage_to_doc_package)
2012-04-24Update build files for 0.6.7.Daniel Hartwig1-1/+1
2012-03-27Update po filesDaniel Hartwig6-6984/+7096
2012-03-27Add architecture grouping policyDaniel Hartwig1-0/+10
2012-03-27Update desc. of 'status' grouping policyDaniel Hartwig1-3/+4
2012-03-25Update translations; unfuzzyDaniel Hartwig6-15494/+16162
2012-03-19Support 'native' and 'foreign' as arguments to ?architectureDaniel Hartwig1-2/+5
* src/generic/apt/apt.{cc,h}: - new functions is_native_arch, is_foreign_arch. * src/generic/apt/matching/*: * doc/en/aptitude.xml: - support 'native' and 'foreign' as arguments to ?architecture.
2012-03-18Finish off "Change the default width of version fields (%V and %v) from 10 ↵Daniel Hartwig1-2/+2
to 14…" This is mainly for commit "a303dcaceacdc6299b9f23cc2375b9e403d20da0" which was ineffective. * src/pkg_columnizer.cc: - really change default width of version columns to 14. * doc/en/aptitude.xml: - document changes to default widths of version columns. * po/{dz,nb}.po: - clear bad msgstr at src/pkg_columnizer.cc:86. * po/ru.po: - default width of 'downloadsize' column: 25 -> 19.
2012-03-18Update build files for 0.6.6.Daniel Hartwig1-1/+1
2012-03-17Clean recent changes to man page description of 'forbid-version'Daniel Hartwig1-3/+2
* doc/en/manpage.xml: - quote the full command line for clearing a forbidden version; - remove the reference to '--schedule-only' which would still try to install the package next time;
2012-03-17Use '~r' as short form of '?architecture'Daniel Hartwig1-2/+2
2012-03-03Add search terms ?architecture, ?multiarchDaniel Hartwig1-0/+58
* ?architecture(architecture) Select packages for the given architecture (such as "amd64", or "all"). * ?multiarch(multiarch) Select packages with a multi-arch capability of multiarch (that is, either "foreign", "same", "allowed", or "none").
2012-03-02Document changes to default width of %D, %I, %o, and %ZDaniel Hartwig1-4/+4
2012-02-24Lower French translation requirementDaniel Hartwig1-1/+1
2012-02-22Minor modification to a phrase in the documentation to make it more clear ↵Manuel A. Fernandez Montecelo1-1/+1
(Closes: #365485)
2012-02-14Update Polish translationsMichał Kułach3-1048/+42
2012-02-08Fix encoding problem with Polish man page.Daniel Hartwig3-641/+764
2012-02-07Pofile changes from "make dist" (i.e., msgmerge).Daniel Hartwig6-13905/+32014
2012-02-07Update build files for 0.6.5.Daniel Hartwig1-1/+1