comic-get allows user to search comics by their name, description, and any other given information such as name of the author if this information is filled in. Syntax for searching is comic-get search keyword.
Example:
% comic-get search IT user-friendly (en_GB) - User Friendly %
Once you've found one or more hit with your search details with comic-get search, you may want to look into package details. This is done with mantra comic-get show package.
Example:
% comic-get show user-friendly Package: user-friendly Version: 2 Compatibility: 2 Section: office Maintainer: Tommi Saviranta <wnd@iki.fi> Language: en_GB Author: JD Illiad Frazer Source: http://www.userfriendly.org/ Description: User Friendly IT-professionals at work %
To install a package, command comic-get install package can be issued. If the comic is available in more than one language, language can be specified by appending =language after the package name such as dilbert=en_GB. Languages are listed with search and show.
If package is available from multiple repositories or in multiple languages, but language was not specified, list of possible candidates is printed, and user is asked to choose one.
Example:
Example: % comic-get install dilbert % ./comic-get.pl install dilbert More than one candidate for dilbert: 0: en_GB using wnd.iki.fi/comic-get 1: en_US using wnd.iki.fi/comic-get Which one should I install? Press enter to cancel. : 0 Installing dilbert (en_GB)... Get:1 http://www.unitedmedia.com/ Dilbert [32.4 KiB] Get:1 http://www.unitedmedia.com/ Dilbert [15.3 KiB] Get:1 http://www.unitedmedia.com/ Dilbert [15.3 KiB] dilbert.png Fetched 49.1 KiB in 8 seconds (6.1 KiB/s, 3 files) %
Sometimes packages write comics in files that have conflicting filenames. When this happens, comic-get prompts you to enter another filename or cancel installation.
Example:
% comic-get install dilbert=en_US Installing dilbert (en_US)... File dilbert.png already installed by dilbert (en_GB) If you would like to install the package anyway enter new filename here. If you want to cancel, just press enter. : foo.png Get:1 http://members.comics.com/ Dilbert [20.0 KiB] Get:1 http://members.comics.com/ Dilbert [15.3 KiB] Get:1 http://members.comics.com/ Dilbert [15.3 KiB] foo.png Fetched 36.6 KiB in 5 seconds (7.3 KiB/s, 3 files) %
If you no longer want upgrade or refresh some of the comics, you can uninstall package with comic-get remove package. Like with install, language can be specified by using =lang after the package name. Also, if more than one package matched given package name, a list will be presented.
Example:
% comic-get remove dilbert More than one package matching dilbert installed: 0: en_GB through wnd.iki.fi/comic-get 1: en_US through wnd.iki.fi/comic-get Which one should I remove? Empty line cancels. : 1 dilbert (en_US) removed. %
Installing a package will only download ruleset to download comics and fetch the latest comic strip. In order to keep your comics fresh and download the latest, comic-get upgrade can be used. This command will try to download the latest comics of installed packages.
Example:
% comic-get upgrade Get:1 http://www.hs.fi/ Viivi ja Vagner [56.9 KiB] Get:1 http://www.hs.fi/ Viivi ja Vagner [49.6 KiB] Get:1 http://www.hs.fi/ Viivi ja Vagner [49.6 KiB] viivi_ja_wagner.png Get:2 http://story.news.yahoo.com/ Garfield [25.6 KiB] Get:2 http://story.news.yahoo.com/ Garfield [26.6 KiB] Get:2 http://story.news.yahoo.com/ Garfield [26.6 KiB] garfield.png Get:3 http://www.unitedmedia.com/ Dilbert [32.4 KiB] Get:3 http://www.unitedmedia.com/ Dilbert [15.3 KiB] Get:3 http://www.unitedmedia.com/ Dilbert [15.3 KiB] dilbert.png Fetched 209.0 KiB in 8 seconds (26.1 KiB/s, 8 files) %
comic-get can retrieve a list of known repositories from official comic-get website by issuing comic-get masterpool. These servers can (probably) be used as repositories.