[Pkg-wmaker-commits] [wmget] 02/16: Remove files removed upstream.
Doug Torrance
dtorrance-guest at moszumanska.debian.org
Mon Feb 8 15:12:35 UTC 2016
This is an automated email from the git hooks/post-receive script.
dtorrance-guest pushed a commit to branch master
in repository wmget.
commit 428f170b1cf115073b7cd8c56b291a1a74b014e3
Author: Doug Torrance <dtorrance at piedmont.edu>
Date: Sun Feb 7 12:12:57 2016 -0500
Remove files removed upstream.
---
Makefile | 179 -------------------
wmget.1 | 217 -----------------------
wmget.refentry.xml | 492 -----------------------------------------------------
3 files changed, 888 deletions(-)
diff --git a/Makefile b/Makefile
deleted file mode 100644
index 483cb55..0000000
--- a/Makefile
+++ /dev/null
@@ -1,179 +0,0 @@
-# Copyright (c) 2001-2003 Aaron Trickey <aaron at amtrickey.net>
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
-# AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-# Makefile for the ``wmget'' (formerly ``wmcurl'') project.
-# This Makefile requires GNU make and probably other GNU stuff...
-
-
-########################################################################
-# Build Targets:
-#
-# all [default]: Builds the wmget application and documentation
-# install: Installs the application
-# uninstall: Attempts to uninstall, if this makefile installed it
-# dockapplib: Recurses into the dockapp dir and builds the library
-# doc: Builds all documentation (okay, it's only a manpage)
-# clean: Cleans, except for generated HTML/man docs
-# docclean: Cleans generated docs
-# slackpkg: Builds a Slackware package in packages/slackware
-# sourceball: Builds a source+docs tarball in packages/source
-########################################################################
-
-all: wmget doc
-
-.PHONY: all install uninstall dockapplib doc clean \
- docclean slackpkg sourceball
-
-
-##### BUILD SETTINGS AND VARIABLES #####################################
-
-# To specify a different prefix, you can override this on the command line
-# make PREFIX=/opt/dockapps install
-PREFIX= /usr/local
-
-INSTALLDIR= install -d -m 755
-INSTALLBIN= install -m 555
-INSTALLMAN= install -m 444
-CC= gcc
-CFLAGS= -Wall -W -I/usr/X11R6/include -O
-# The following line is what I use during development
-#CFLAGS:= $(CFLAGS) -Werror -g
-LDFLAGS= -L/usr/X11R6/lib -lXpm -lXext -lX11 -lm -lcurl
-DOCS= wmget.1
-
-VERSION:= $(shell grep '\#define WMGET_VERSION ' wmget.h \
- | sed -e 's/.*"\(.*\)".*/\1/' )
-
-OBJS= server.o \
- request.o \
- cancel.o \
- list.o \
- retrieve.o \
- iq.o \
- wmget.o \
- configure.o \
- messages.o \
- usage.o
-
-DALIBDIR= dockapp
-DALIB= $(DALIBDIR)/dockapp.a
-
-ALL_SRCS= $(subst .o,.c,$(OBJS))
-
-
-##### PROGRAM ##########################################################
-
-install: all
- echo $(PREFIX) > install.prefix ; \
- $(INSTALLDIR) $(PREFIX)/bin ; \
- $(INSTALLBIN) wmget $(PREFIX)/bin/wmget ; \
- $(INSTALLDIR) $(PREFIX)/man/man1 ; \
- $(INSTALLMAN) wmget.1 $(PREFIX)/man/man1/wmget.1 ; \
-
-uninstall:
- cd `cat install.prefix` && rm -f bin/wmget man/man1/wmget.1
- rm -f install.prefix
-
-wmget: dockapplib $(OBJS)
- $(CC) $(CFLAGS) $(LDFLAGS) $(OBJS) $(DALIB) -o $@
-
-
-##### LIBRARY ##########################################################
-
-dockapplib:
- make -C $(DALIBDIR)
-
-
-
-##### DOCUMENTATION ####################################################
-
-doc: $(DOCS)
-
-
-# NOTE: The wmget refentry page uses an <?xml-stylesheet?> PI, I use an XML
-# catalog file to map the given URL to a local path
-
-wmget.1: wmget.refentry.xml
- xsltproc --nonet $<
-
-
-##### CLEANUP ##########################################################
-
-clean:
- rm -f *.o wmget core pod2html-* install.prefix \
- wmget.html
- make -C dockapp clean
-
-docclean:
- rm -f $(DOCS)
-
-
-##### SLACKWARE PACKAGE ################################################
-
-SLACK_PFX= slackroot/$(PREFIX)
-SLACK_PACKAGE= packages/slackware/wmget-$(VERSION).tgz
-
-slackpkg: wmget doc
- -mkdir -p packages/slackware
- rm -rf slackroot
- $(INSTALLDIR) $(SLACK_PFX)
- $(INSTALLDIR) $(SLACK_PFX)/bin
- $(INSTALLDIR) $(SLACK_PFX)/man
- $(INSTALLDIR) $(SLACK_PFX)/man/man1
- $(INSTALLBIN) wmget $(SLACK_PFX)/bin/wmget
- $(INSTALLMAN) wmget.1 $(SLACK_PFX)/man/man1/wmget.1
- cd slackroot && \
- tar czv -f ../$(SLACK_PACKAGE) \
- --owner=root \
- --group=root \
- *
- rm -rf slackroot
-
-
-##### SOURCE PACKAGE ###################################################
-
-SOURCEBALL= packages/source/wmget-$(VERSION)-src.tar.gz
-
-sourceball: doc clean
- -mkdir -p packages/source
- cd .. && \
- tar czv --exclude RCS \
- --exclude .\* \
- --exclude packages \
- --exclude tags \
- --exclude \*~ \
- --exclude working \
- --exclude www \
- -f wmget/$(SOURCEBALL) \
- wmget
-
-
-##### WEB SITE #########################################################
-
-WWW_SRC= $(HOME)/amtrickey.net/src
-WWW_DOWNLOAD= $(WWW_SRC)/download
-WWW_WMGET= $(WWW_SRC)/wmget
-
-www: slackpkg sourceball
- cp $(SLACK_PACKAGE) $(WWW_DOWNLOAD)
- cp $(SOURCEBALL) $(WWW_DOWNLOAD)
- cp NEWS wmget.refentry.xml $(WWW_WMGET)
-
-
-
diff --git a/wmget.1 b/wmget.1
deleted file mode 100644
index 0c20a02..0000000
--- a/wmget.1
+++ /dev/null
@@ -1,217 +0,0 @@
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "WMGET" 1 "" "" ""
-.SH NAME
-wmget \- Background download manager in a dockapp
-.SH "SYNOPSIS"
-.ad l
-.hy 0
-.HP 6
-\fBwmget\fR dock [\fIoptions\fR]
-.ad
-.hy
-.ad l
-.hy 0
-.HP 6
-\fBwmget\fR [\fIoptions\fR] {\fIURL\fR}
-.ad
-.hy
-.ad l
-.hy 0
-.HP 6
-\fBwmget\fR cancel {\fIjob\-id\fR}
-.ad
-.hy
-.ad l
-.hy 0
-.HP 6
-\fBwmget\fR list
-.ad
-.hy
-
-.SH "DESCRIPTION"
-
-.PP
-wmget is a ``dockapp'' which makes it more convenient to retrieve files in the background\&. Dockapps are applications which run in small windows intended to be ``docked'' in window manager\-provided locations\&. wmget was developed primarily under GNU Window Maker, the author's preferred WM, but is known to work under AfterStep as well, and should work with other dockapp\-aware window managers and docks\&.
-
-.PP
-It uses the excellent libcurl library, part of the Curl automated\-download program, to perform file retrieval from Web servers, FTP servers, and other sources\&.
-
-.PP
-wmget allows you to perform multiple downloads without keeping a terminal open (for FTP or curl or something) or another window on your desktop (e\&.g\&. for Mozilla download progress); download progress is visible any time the Dock is visible\&.
-
-.PP
-You start downloads either by ``pasting'' URLs from Web browsers or other applications, or by invoking wmget from the command line (or another script or program) with a source URL\&. The dockapp has a handful of configurable download options, such as target directory, HTTP proxy server, etc\&.
-
-.SH "STARTING UP"
-
-.PP
-To start the dockapp, just run \fBwmget dock &\fR\&. If you are running Window Maker, you can then just drag the new appicon onto your Dock, right\-click on an area outside the four progress bars, select Settings, and select Start when Window Maker is started\&.
-
-.PP
-If you are running AfterStep, you can add it to your Wharf by adding the following line to your \fI~/GNUstep/Library/AfterStep/wharf\fR file:
-
-.nf
-
- *Wharf wmget \- Swallow "wmget" wmget dock &
-
-.fi
-
-.PP
-Other window managers support dockapps in different ways\&. Even in window managers without any special dockapp support, you can run wmget as noted above; it will simply show up as a small window or "icon"\&.
-
-.SH "USING WMGET"
-
-.PP
-wmget's user interface is simple: four stacked progress bars, initially empty, representing four possible simultaneous downloads\&. The top bar will say ``wmget'' when there isn't a download running there, but any download will cover that up\&.
-
-.PP
-Each running download normally shows up to nine characters of its filename, overlaid with a progress bar\&. You can click on any progress bar to reveal a percentage display and a stop button; clicking on the percentage display switches back, while clicking on the stop button stops the download\&. There is currently no confirmation; it just stops\&.
-
-.PP
-You can ``request'' downloads at any time\&. If all four places show running downloads, additional requests will queue up, waiting for one to complete; wmget will never be downloading more than four files at a time\&.
-
-.PP
-By default, wmget figures out a reasonable filename for any requested downloads, writes them to your home directory, and won't overwrite an existing file by the same name\&. All of these, along with a few other options, are configurable\&. See below\&.
-
-.SS "Requesting Downloads with the Mouse"
-
-.PP
-The easiest way to request a download is by copying and pasting a link\&. wmget lets you paste a URL by middle\-clicking anywhere on any of its status bars\&. Simply copy a link from some other source (for example, by right\-clicking on a link in Mozilla or Netscape and picking Copy Link Location), and middle\-click on one of the progress meter boxes in wmget\&.
-
-.SS "Requesting Downloads from the Command Line"
-
-.PP
-The \fBwmget\fR command also lets you directly request downloads from the command line, or from within a script or another program\&. The syntax is \fBwmget \fIURL\fR\fR, plus any of the options documented below\&.
-
-.PP
-Once you run this command, you'll either get an error message or a ``job ID''\&. The job ID is only useful in conjunction with the \fBwmget cancel\fR command\&.
-
-.SS "Download Failures"
-
-.PP
-Downloads can fail for a variety of reasons, from running out of disk space to modem hangups\&. Since wmget is designed not to interrupt your workflow or exceed its little square window, it responds to any download error by aborting the download and writing an error file to your download directory\&. This error file has the name \fIfile\&.ERROR\fR, where \fIfile\fR is the name of the actual download target\&. This error file is a plain text file containing information on what you were do [...]
-
-.SS "Viewing and Canceling Downloads"
-
-.PP
-As noted above, you can see the currently\-running downloads in the four progress boxes on the dockapp\&. Clicking on a bar reveals a stop button, and clicking on that stop button cancels the download (but leaves the partially\-downloaded file on your computer)\&.
-
-.PP
-At any time, you can also run the \fBwmget list\fR command, which displays all the running downloads as well as any queued\-up requests\&. The listing contains entries like this:
-
-.IP
-.nf
-Job 10 [linux\-2\&.6]: 1658544/33073407 RUNNING
-ftp://ftp\&.kernel\&.org/pub/linux/kernel/v2\&.6/linux\-2\&.6\&.0\-test6\&.tar\&.bz2
-=> /home/aaron/DOWNLOAD/linux\-2\&.6\&.0\-test6\&.tar\&.bz2
-
-.fi
-
-.PP
-What you see in that (admittedly dense) listing are the job ID, the name of the download as displayed on the dockapp (surrounded in brackets), the progress in bytes, the total bytes to download, the current status, the source URL, and the target file on your computer\&. Whew\&.
-
-.PP
-You can cancel any requested or running download from the command line by specifying \fBwmget cancel \fIjob\-id\fR\fR\&.
-
-.SH "COMMAND-LINE OPTIONS AND THE CONFIGURATION FILE"
-
-.PP
-wmget supports a handful of configuration options\&. You can specify defaults for all downloads by putting them in a configuration file or adding command\-line options to the \fBwmget dock\fR command at startup, or you can specify options for one specific download by adding options to the \fBwmget \fIURL\fR\fR command when you request them\&. There isn't any way to specify options on URLs you paste with the mouse\&. Dockapp command\-line arguments override config\-file settings, and per\ [...]
-
-.PP
-The configuration file is an optional file named \fI\&.wmgetrc\fR in your home directory\&. If it's there, it's parsed by the dockapp at startup\&. The syntax is simple: one option per line, all options consisting of a name and possibly a value\&. Blank lines are okay, and lines starting with # are ignored (so you can disable options easily)\&. Option names are just the same as the command\-line option names given below, except you don't put the dashes (``\-\-'') and you can't use the on [...]
-
-.TP
-\-\-version, \-v
-Regardless of any other options, this prints out version and copyright information and exits\&.
-
-.TP
-\-\-help, \-h
-Regardless of any other options, this prints out a help message and exits\&.
-
-.TP
-\-\-silent, \-s
-Suppress any output text other than error messages\&.
-
-.TP
-\-\-verbose, \-V
-Write extra debugging information; not very useful unless you're debugging or extending the software\&.
-
-.TP
-\-\-output \fIpathname\fR, \-o \fIpathname\fR
-Specifies where to write downloaded files\&. In the config file or on the dockapp command line, this can only be used to specify your default download directory; it must be an existing directory, and if it's not absolute then it is assumed to be relative to your home directory\&. On a specific download request, this can provide an alternate save directory or even an alternate filename; in that case, a non\-absolute path is relative to the default download directory\&.
-
-.TP
-\-\-display \fIname\fR, \-d \fIname\fR
-Display the first nine characters of \fIname\fR in the progress display for this file\&. (Only valid on specific download requests, not on the dockapp or in the config file\&.)
-
-.TP
-\-\-overwrite, \-O
-Allow wmget to overwrite an existing file when downloading\&. Normally, it will refuse to do so\&.
-
-.TP
-\-\-continue, \-C
-When fetching a file that already exists locally, assume the local copy was an aborted download and try to download just the remainder\&.
-
-.TP
-\-\-auth \fIusername\fR:\fIpassword\fR, \-a \fIusername\fR:\fIpassword\fR
-Provides login information for the server from which you're downloading\&.
-
-.TP
-\-\-proxy \fIserver\fR:\fIport\fR, \-p \fIserver\fR:\fIport\fR, \-\-proxy_auth \fIuser\fR:\fIpassword\fR, \-P \fIuser\fR:\fIpassword\fR
-Specifies a proxy server and optionally a proxy\-server username/password pair for getting past firewalls\&.
-
-.TP
-\-\-follow \fIN\fR, \-f \fIN\fR
-Specifies how many HTTP redirects to follow when resolving a page; by default, wmget is configured to follow up to 5\&. Set this to 0 to disable redirection\&. (In any real\-world situation, if you're getting redirected more than 5 times, there's a problem\&.\&.\&.)
-
-.TP
-\-\-user\-agent \fIstring\fR, \-U \fIstring\fR
-Specifies which User\-Agent string to provide to servers when performing HTTP downloads\&. The default User\-Agent names both the wmget and libcurl versions in use\&.
-
-.TP
-\-\-ascii, \-B
-Force FTP downloads to use ASCII mode; normally, they use binary mode\&. If you're downloading text documents, ASCII mode will take care of any necessary conversions between the text formats of the server and your computer\&.
-
-.TP
-\-\-referer \fIstring\fR, \-e \fIstring\fR
-Provides a ``referer'' string to the Web server\&.
-
-.TP
-\-\-interface \fIinterface\fR, \-\-n \fIinterface\fR
-Names a specific network interface to use (e\&.g\&., eth0 for the first Ethernet interface on a Linux system)\&. Rarely needed\&.
-
-.TP
-\-\-headers, \-h
-When performing an HTTP retrieval, include the HTTP message header in the saved file\&. This is only really useful for testing\&.
-
-.SH "FILES"
-
-.TP
-\fI~/\&.wmgetrc\fR
-The (optional) configuration file for the wmget dockapp\&. Settings in this file are used to specify defaults for the dockapp when it starts; see the section on configuration and command\-line options for more details\&.
-
-.TP
-\fI~/\&.wmget\&.iq\fR
-A Unix\-domain socket created by the wmget dockapp to accept requests from wmget commands\&. Created at startup automatically\&.
-
-.SH AUTHOR
-Aaron Trickey.
diff --git a/wmget.refentry.xml b/wmget.refentry.xml
deleted file mode 100644
index 0b65011..0000000
--- a/wmget.refentry.xml
+++ /dev/null
@@ -1,492 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<?xml-stylesheet
- href="http://docbook.sourceforge.net/release/xsl/1.62/manpages/docbook.xsl"
- type="text/xsl"?>
-<!--
-<!DOCTYPE refentry
- PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<!DOCTYPE refentry
- PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "/usr/local/docbook/docbookx.dtd">
- -->
-
-<!DOCTYPE refentry
- PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd">
-
-<refentry>
- <refentryinfo>
- <author>
- <firstname>Aaron</firstname><surname>Trickey</surname>
- <email>aaron at amtrickey.net</email>
- </author>
- <copyright>
- <year>2001</year>
- <year>2002</year>
- <year>2003</year>
- <holder>Aaron Trickey</holder>
- </copyright>
- </refentryinfo>
-
- <refmeta>
- <refentrytitle>wmget</refentrytitle>
- <manvolnum>1</manvolnum>
- </refmeta>
-
- <refnamediv>
- <refname>wmget</refname>
- <refpurpose>Background download manager in a dockapp</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>wmget</command>
- <arg choice="plain">dock</arg>
- <arg choice="opt"><replaceable>options</replaceable></arg>
- </cmdsynopsis>
- <cmdsynopsis>
- <command>wmget</command>
- <arg choice="opt"><replaceable>options</replaceable></arg>
- <arg choice="req"><replaceable>URL</replaceable></arg>
- </cmdsynopsis>
- <cmdsynopsis>
- <command>wmget</command>
- <arg choice="plain">cancel</arg>
- <arg choice="req"><replaceable>job-id</replaceable></arg>
- </cmdsynopsis>
- <cmdsynopsis>
- <command>wmget</command>
- <arg choice="plain">list</arg>
- </cmdsynopsis>
- </refsynopsisdiv>
-
- <refsect1>
- <title>Description</title>
- <para>
- wmget is a ``dockapp'' which makes it more convenient to
- retrieve files in the background. Dockapps are applications
- which run in small windows intended to be ``docked'' in window
- manager-provided locations. wmget was developed primarily under
- GNU Window Maker, the author's preferred WM, but is known to
- work under AfterStep as well, and should work with other
- dockapp-aware window managers and docks.
- </para>
- <para>
- It uses the excellent libcurl library, part of the Curl
- automated-download program, to perform file retrieval from Web
- servers, FTP servers, and other sources.
- </para>
- <para>
- wmget allows you to perform multiple downloads without keeping a
- terminal open (for FTP or curl or something) or another window
- on your desktop (e.g. for Mozilla download progress); download
- progress is visible any time the Dock is visible.
- </para>
- <para>
- You start downloads either by ``pasting'' URLs from Web browsers
- or other applications, or by invoking wmget from the command
- line (or another script or program) with a source URL. The
- dockapp has a handful of configurable download options, such as
- target directory, HTTP proxy server, etc.
- </para>
- </refsect1>
-
- <refsect1>
- <title>Starting Up</title>
- <para>
- To start the dockapp, just run <command>wmget dock
- &</command>. If you are running Window Maker, you can then
- just drag the new appicon onto your Dock, right-click on an area
- outside the four progress bars, select
- <guimenuitem>Settings</guimenuitem>, and select <guilabel>Start
- when Window Maker is started</guilabel>.
- </para>
-
- <para>
- If you are running AfterStep, you can add it to your Wharf by
- adding the following line to your
- <filename>~/GNUstep/Library/AfterStep/wharf</filename> file:
- </para>
-
- <informalfigure>
- <programlisting>
- *Wharf wmget - Swallow "wmget" wmget dock &
- </programlisting>
- </informalfigure>
-
- <para>
- Other window managers support dockapps in different ways. Even in
- window managers without any special dockapp support, you can run
- wmget as noted above; it will simply show up as a small window or
- "icon".
- </para>
- </refsect1>
-
- <refsect1>
- <title>Using wmget</title>
- <para>
- wmget's user interface is simple: four stacked progress bars,
- initially empty, representing four possible simultaneous
- downloads. The top bar will say ``wmget'' when there isn't a
- download running there, but any download will cover that up.
- </para>
- <para>
- Each running download normally shows up to nine characters of its
- filename, overlaid with a progress bar. You can click on any
- progress bar to reveal a percentage display and a stop button;
- clicking on the percentage display switches back, while clicking
- on the stop button stops the download. There is currently no
- confirmation; it just stops.
- </para>
- <para>
- You can ``request'' downloads at any time. If all four places
- show running downloads, additional requests will queue up, waiting
- for one to complete; wmget will never be downloading more than
- four files at a time.
- </para>
- <para>
- By default, wmget figures out a reasonable filename for any
- requested downloads, writes them to your home directory, and won't
- overwrite an existing file by the same name. All of these, along
- with a few other options, are configurable. See below.
- </para>
-
- <refsect2>
- <title>Requesting Downloads with the Mouse</title>
- <para>
- The easiest way to request a download is by copying and pasting
- a link. wmget lets you paste a URL by middle-clicking anywhere
- on any of its status bars. Simply copy a link from some other
- source (for example, by right-clicking on a link in Mozilla or
- Netscape and picking <guimenuitem>Copy Link
- Location</guimenuitem>), and middle-click on one of the progress
- meter boxes in wmget.
- </para>
- </refsect2>
-
- <refsect2>
- <title>Requesting Downloads from the Command Line</title>
- <para>
- The <command>wmget</command> command also lets you directly
- request downloads from the command line, or from within a script
- or another program. The syntax is <command>wmget
- <replaceable>URL</replaceable></command>, plus any of the
- options documented below.
- </para>
- <para>
- Once you run this command, you'll either get an error message or
- a ``job ID''. The job ID is only useful in conjunction with the
- <command>wmget cancel</command> command.
- </para>
- </refsect2>
-
- <refsect2>
- <title>Download Failures</title>
- <para>
- Downloads can fail for a variety of reasons, from running out of
- disk space to modem hangups. Since wmget is designed not to
- interrupt your workflow or exceed its little square window, it
- responds to any download error by aborting the download and
- writing an error file to your download directory. This error
- file has the name <filename>file.ERROR</filename>, where
- <filename>file</filename> is the name of the actual download
- target. This error file is a plain text file containing
- information on what you were downloading and what went wrong.
- </para>
- </refsect2>
-
- <refsect2>
- <title>Viewing and Canceling Downloads</title>
- <para>
- As noted above, you can see the currently-running downloads in
- the four progress boxes on the dockapp. Clicking on a bar
- reveals a stop button, and clicking on that stop button cancels
- the download (but leaves the partially-downloaded file on your
- computer).
- </para>
- <para>
- At any time, you can also run the <command>wmget list</command>
- command, which displays all the running downloads as well as any
- queued-up requests. The listing contains entries like this:
- </para>
-<informalfigure><screen
->Job 10 [linux-2.6]: 1658544/33073407 RUNNING
-ftp://ftp.kernel.org/pub/linux/kernel/v2.6/linux-2.6.0-test6.tar.bz2
-=> /home/aaron/DOWNLOAD/linux-2.6.0-test6.tar.bz2
-</screen></informalfigure>
- <para>
- What you see in that (admittedly dense) listing are the job ID,
- the name of the download as displayed on the dockapp (surrounded
- in brackets), the progress in bytes, the total bytes to
- download, the current status, the source URL, and the target
- file on your computer. Whew.
- </para>
- <para>
- You can cancel any requested or running download from the
- command line by specifying <command>wmget cancel
- <replaceable>job-id</replaceable></command>.
- </para>
- </refsect2>
- </refsect1>
-
- <refsect1>
- <title>Command-Line Options and the Configuration File</title>
- <para>
- wmget supports a handful of configuration options. You can
- specify defaults for all downloads by putting them in a
- configuration file or adding command-line options to the
- <command>wmget dock</command> command at startup, or you can
- specify options for one specific download by adding options to the
- <command>wmget <replaceable>URL</replaceable></command> command
- when you request them. There isn't any way to specify options on
- URLs you paste with the mouse. Dockapp command-line arguments
- override config-file settings, and per-URL settings override
- dockapp settings.
- </para>
- <para>
- The configuration file is an optional file named
- <filename>.wmgetrc</filename> in your home directory. If it's
- there, it's parsed by the dockapp at startup. The syntax is
- simple: one option per line, all options consisting of a name and
- possibly a value. Blank lines are okay, and lines starting with #
- are ignored (so you can disable options easily). Option names are
- just the same as the command-line option names given below, except
- you don't put the dashes (``--'') and you can't use the one-letter
- abbreviations.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>--version</term>
- <term>-v</term>
- <listitem>
- <para>
- Regardless of any other options, this prints out version and
- copyright information and exits.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--help</term>
- <term>-h</term>
- <listitem>
- <para>
- Regardless of any other options, this prints out a help
- message and exits.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--silent</term>
- <term>-s</term>
- <listitem>
- <para>
- Suppress any output text other than error messages.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--verbose</term>
- <term>-V</term>
- <listitem>
- <para>
- Write extra debugging information; not very useful unless
- you're debugging or extending the software.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--output <replaceable>pathname</replaceable></term>
- <term>-o <replaceable>pathname</replaceable></term>
- <listitem>
- <para>
- Specifies where to write downloaded files. In the config
- file or on the dockapp command line, this can only be used
- to specify your default download directory; it must be an
- existing directory, and if it's not absolute then it is
- assumed to be relative to your home directory. On a
- specific download request, this can provide an alternate
- save directory or even an alternate filename; in that case,
- a non-absolute path is relative to the default download
- directory.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--display <replaceable>name</replaceable></term>
- <term>-d <replaceable>name</replaceable></term>
- <listitem>
- <para>
- Display the first nine characters of
- <replaceable>name</replaceable> in the progress display for
- this file.
- (Only valid on specific download requests, not on the
- dockapp or in the config file.)
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--overwrite</term>
- <term>-O</term>
- <listitem>
- <para>
- Allow wmget to overwrite an existing file when downloading.
- Normally, it will refuse to do so.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--continue</term>
- <term>-C</term>
- <listitem>
- <para>
- When fetching a file that already exists locally, assume the
- local copy was an aborted download and try to download just
- the remainder.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--auth <replaceable>username</replaceable>:<replaceable>password</replaceable></term>
- <term>-a <replaceable>username</replaceable>:<replaceable>password</replaceable></term>
- <listitem>
- <para>
- Provides login information for the server from which you're
- downloading.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--proxy
- <replaceable>server</replaceable>:<replaceable>port</replaceable>
- </term>
- <term>-p
- <replaceable>server</replaceable>:<replaceable>port</replaceable>
- </term>
- <term>--proxy_auth
- <replaceable>user</replaceable>:<replaceable>password</replaceable>
- </term>
- <term>-P
- <replaceable>user</replaceable>:<replaceable>password</replaceable>
- </term>
- <listitem>
- <para>
- Specifies a proxy server and optionally a proxy-server
- username/password pair for getting past firewalls.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--follow <replaceable>N</replaceable></term>
- <term>-f <replaceable>N</replaceable></term>
- <listitem>
- <para>
- Specifies how many HTTP redirects to follow when resolving a
- page; by default, wmget is configured to follow up to 5.
- Set this to 0 to disable redirection. (In any real-world
- situation, if you're getting redirected more than 5 times,
- there's a problem...)
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--user-agent <replaceable>string</replaceable></term>
- <term>-U <replaceable>string</replaceable></term>
- <listitem>
- <para>
- Specifies which User-Agent string to provide to servers when
- performing HTTP downloads. The default User-Agent names
- both the wmget and libcurl versions in use.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--ascii</term>
- <term>-B</term>
- <listitem>
- <para>
- Force FTP downloads to use ASCII mode; normally, they use
- binary mode. If you're downloading text documents, ASCII
- mode will take care of any necessary conversions between
- the text formats of the server and your computer.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--referer <replaceable>string</replaceable></term>
- <term>-e <replaceable>string</replaceable></term>
- <listitem>
- <para>
- Provides a ``referer'' string to the Web server.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--interface <replaceable>interface</replaceable></term>
- <term>--n <replaceable>interface</replaceable></term>
- <listitem>
- <para>
- Names a specific network interface to use (e.g., eth0 for
- the first Ethernet interface on a Linux system). Rarely
- needed.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>--headers</term>
- <term>-h</term>
- <listitem>
- <para>
- When performing an HTTP retrieval, include the HTTP message
- header in the saved file. This is only really useful for
- testing.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
- <refsect1>
- <title>Files</title>
- <variablelist>
- <varlistentry>
- <term><filename>~/.wmgetrc</filename></term>
- <listitem>
- <para>
- The (optional) configuration file for the wmget dockapp.
- Settings in this file are used to specify defaults for the
- dockapp when it starts; see the section on configuration and
- command-line options for more details.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><filename>~/.wmget.iq</filename></term>
- <listitem>
- <para>
- A Unix-domain socket created by the wmget dockapp to accept
- requests from wmget commands. Created at startup
- automatically.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
-
-</refentry>
-
-
-
-
-
-
-
-
-
-
-
-
-
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-wmaker/wmget.git
More information about the Pkg-wmaker-commits
mailing list