On Sat, 4 Nov 2006, Graham Williams wrote:
Thanks for the suggestion. More than happy to take up your offer of
putting together your proposals for a rationalisation.
Here's a revised list. I've tried mostly to rationalise the names,
removing dups. One assumption is that wajig users will have a good
completion mechanism, and will use many commands rarely, so that
descriptive names are often better than short ones. (I just submitted a
script derived from bash_completion.py to fish upstream.)
There are a lot of changes here, some minor, some less minor. I'm not
sure there's an easy summary. Perhaps diff against list-commands?
addcdrom Add a CD-ROM to the list of available sources of packages
auto-alts Mark the alternative to be auto set (using set priorities)
auto-clean Remove superseded .deb files from the download cache
auto-download Do an update followed by a download of all updated packages
auto-install Perform an install without asking questions (non-interactive)
available-version List versions of packages available for installation
bug Check reported bugs in package using the Debian Bug Tracker
build Retrieve/unpack sources and build .deb for the named packages
build-depend Retrieve packages required to build listed packages
changelog Retrieve up-to-date changelog for the package
changelog-new Retrieve the latest changelog entries for package
clean Remove all .deb files from the download cache
commands List all the JIG commands and one line descriptions for each
daily-upgrade Perform an update, then dist-upgrade
dependents List of packages which depend/recommend/suggest the package
describe One line description of packages (-v and -vv for more detail)
describe-new One line description of new packages
detail Provide a detailed description of package (describe -vv)
detail-new Provide a detailed description of new packages (describe -vv)
dist-upgrade Upgrade to new distribution (installed and new rqd packages)
download Download package files ready for an install
download-depends Download package and any packages it depends on
find-file Search for a file within installed packages
find-unofficial Search for an unofficial Debian package at apt-get.org
fix-configure Perform dpkg --configure -a (to fix interrupted configure)
fix-install Perform apt-get -f install (to fix broken dependencies)
fix-missing Perform apt-get --fix-missing upgrade
help Print documentation (-v or -vv for more detail)
hold Place listed packages on hold so they are not upgraded
init (Re)initialise the JIG archive files
install Install (or upgrade) one or more packages or .deb files
install-force Install packages and ignore file overwrites and depends
install-recommended Install package and associated recommended packages
install-recommended-suggested Install package and recommended and suggested
packages
install-suggested Install package and associated suggested packages
install/dist Install packages from specified distribution
last-update Identify when an update was last performed
list List the status and description of installed packages
list-all List a one line description of given or all packages
list-alts List the objects that can have alternatives configured
list-cache List the contents of the download cache
list-daemons List the daemons that JIG can start/stop/restart
list-files List the files that are supplied by the named package
list-hold List those packages on hold
list-installed List packages (with optional argument substring) installed
list-large List size of all large (>10MB) installed packages
list-log List the contents of the install/remove log file (filtered)
list-names List all known packages or those containing supplied string
list-scripts List the control scripts of the package of .deb file
list-section List packages that belong to a specific section
list-sections List the sections that are available
list-status Same as list but only prints first two columns, not truncated
list-upgradeable List packages with newer versions available for upgrading
list-versions Generates list of package=version for all installed packages
list-wide Same as list but avoids truncating package names
local-dist-upgrade Dist-upgrade using packages already downloaded
local-upgrade Upgrade using packages already downloaded, but not any others
madison Runs the madison command of apt-cache
move Move packages in the download cache to a local Debian mirror
new List packages that became available since last update
new-upgrades List packages newly available for upgrading
non-free List installed packages that do not meet the DFSG
orphans List libraries not required by any installed package
policy From preferences file show priorities/policy for available
packages
purge Remove one or more packages and configuration files
purge-depend Purge package and those it depends on that are not required by
others
purge-orphans Purge orphaned libraries (not required by installed packages)
readme Display the package's README file from /usr/share/doc
reconfigure Reconfigure the named installed packages or run gkdebconf
reinstall Reinstall the named packages
reload Reload daemon configs (see list-daemons)
remove Remove one or more packages (see also purge)
remove-depend Remove package and its dependees not required by others
remove-orphans Remove orphaned libraries (not required by installed packages)
repackage Generate a .deb file from an installed package
restart Restart a daemon (see list-daemons)
rpm2deb Convert a RedHat .rpm file to a Debian .deb file
rpminstall Install a RedHat .rpm package
search Search for packages containing listed words
search-apt Find local Debian archives suitable for sources.list
setup Configure the sources.list file which locates Debian archives
size Print out the size (in Kb) of all, or listed, installed packages
source Retrieve and unpack sources for the named packages
start Start a daemon (see list-daemons)
status Show the version and available version of packages
status-match Show the version and available version of matching packages
stop Stop a daemon (see list-daemons)
tasksel Run the Gnome task selector to install groups of packages
unhold Remove listed packages from hold so they are again upgraded
update Update the list of downloadable packages
update-alts Update default alternative for things like x-window-manager
update-pci-ids Updates the local list of PCI ids from the internet master list
update-usb-ids Updates the local list of USB ids from the internet master list
upgrade Upgrade all of the installed packages or just those listed
verify Check the integrity of installed packages (with debsums)
versions List version and distribution of (all) packages
whichpkg Find the package that supplies the given command or file
These should be performed by --simulate:
showdistupgrade Trace the steps that a dist-upgrade would perform
showinstall Trace the steps that an install would perform
showremove Trace the steps that a remove would perform
showupgrade Trace the steps that an upgrade would perform
I suggest that --simulate shouldn't show the actual commands executed,
that's --teach's job. You can use --simulate --teach if you want to see
the commands performed without doing them.
These should be replaced by allowing a file argument --from-file=FILE
anywhere a package list is needed:
file-download Download packages listed in file ready for an install
file-install Install packages listed in a file
file-remove Remove packages listed in a file
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
