summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorXavier Chantry <shiningxc@gmail.com>2008-08-23 16:34:42 +0200
committerDan McGee <dan@archlinux.org>2008-08-25 18:23:05 -0500
commitd6f62ba22d5c6da484f4a7f0876b203ad545342a (patch)
treecd86d18043bbf03bdd26b1b1dad1fed3e8b666b7 /doc
parent24d7c6a372ee9e796b4112f6dbff5f188fc80d35 (diff)
makepkg : allow to specify a download filename
A source entry can now have the following form, to specify a different filename : "filename::http://path/to/file" Of course, the old syntax is still supported : "http://path/to/file" And as before, in the second case, the filename used is simply "file". This fixes FS#11292, because handling multiple source files with the same name is now possible (just choose a different filename). But it will also allow to deal much more nicely with funny url like this by using a sane filename (and unfortunately, there are quite a few) : http://www.vim.org/scripts/download_script.php?src_id=6992 Signed-off-by: Xavier Chantry <shiningxc@gmail.com> Signed-off-by: Dan McGee <dan@archlinux.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/PKGBUILD.5.txt4
-rw-r--r--doc/makepkg.conf.5.txt13
2 files changed, 11 insertions, 6 deletions
diff --git a/doc/PKGBUILD.5.txt b/doc/PKGBUILD.5.txt
index 0b1ce649..9db10576 100644
--- a/doc/PKGBUILD.5.txt
+++ b/doc/PKGBUILD.5.txt
@@ -87,6 +87,10 @@ similar to `$_basekernver`.
variables if possible when specifying the download location. Any files
that are compressed will automatically be extracted, unless found in
the noextract array listed below.
++
+It is also possible to specify an optional filename, which is helpful
+with weird URLs and for handling multiple source files with the same
+name. The syntax is: `source=('filename::url')`
*noextract (array)*::
An array of filenames corresponding to those from the source array. Files
diff --git a/doc/makepkg.conf.5.txt b/doc/makepkg.conf.5.txt
index 8b39c467..b5398af7 100644
--- a/doc/makepkg.conf.5.txt
+++ b/doc/makepkg.conf.5.txt
@@ -34,12 +34,13 @@ Options
**DLAGENTS=(**\'protocol::/path/to/command [options]' ...**)**::
Sets the download agents used to fetch source files specified with a URL in
the linkman:PKGBUILD[5] file. Options can be specified for each command as
- well; the download URL is placed on the end of the command. This is more
- flexible than the former `FTPAGENT` variable, as any protocol can have a
- download agent. Several examples are provided in the default makepkg.conf.
- All instances of `%u` will be replaced with the download URL. If present,
- instances of `%o` will be replaced with the local filename, plus a ``.part''
- extension, which allows to do file resumes properly.
+ well, and any protocol can have a download agent. Several examples are provided
+ in the default makepkg.conf.
+ +
+ If present, `%u` will be replaced with the download URL. Otherwise, the
+ download URL will be placed on the end of the command. If present, `%o` will
+ be replaced with the local filename, plus a ``.part'' extension, which allows
+ makepkg to handle resuming file downloads.
**CARCH=**"carch"::
Specifies your computer architecture; possible values include such things