mirrors/fdroidserver
1
0
Fork 0
mirror of https://github.com/f-droid/fdroidserver.git synced 2025-09-13 22:42:29 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions

Updated docs for separate server tools and data repositories

Browse source
This commit is contained in:
Ciaran Gultnieks 2012-03-11 21:03:55 +00:00
parent 3680beca30
commit abffbdd535
1 changed files with 22 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

36
docs/fdroid.texi
View file

@ -124,17 +124,29 @@ Paramiko (debian package python-paramiko)
@cindex setup, installation @cindex setup, installation
Because the tools and data will always change rapidly, you will almost Because the tools and data will always change rapidly, you will almost
certainly want to work from a git clone of the tools, which are designed to certainly want to work from a git clone of the tools at this stage. To
work in this way, with all associated data in a pre-defined directory get started:
structure below the main one. To get started:
@example @example
git clone git://gitorious.org/f-droid/fdroidserver.git git clone git://gitorious.org/f-droid/fdroidserver.git
cd fdroidserver
@end example @end example
You will now be in the root directory of the tools. All the tasks associated You now have lots of stuff in the fdroidserver directory, but the most
with managing the repository and data are done from here. important is the 'fdroid' command script which you run to perform all tasks.
This script is always run from a repostitory data directory, so the
most sensible thing to do next is to put your new fdroidserver directory
in your @code{PATH}.
@section Data
To do anything, you'll need at least one repository data directory. It's
from this directory that you run the @code{fdroid} command to perform all
repository management tasks. You can either create a brand new one, or
grab a copy of the data used by the main F-Droid repository:
@example
git clone git://gitorious.org/f-droid/fdroiddata.git
@end example
Regardless of the intended usage of the tools, you will always need to set Regardless of the intended usage of the tools, you will always need to set
up some basic configuration details. This is done by creating a file called up some basic configuration details. This is done by creating a file called
@ -142,18 +154,14 @@ up some basic configuration details. This is done by creating a file called
and then editing according to the instructions within. and then editing according to the instructions within.
Once configured in this way, all the functionality of the tools is accessed Once configured in this way, all the functionality of the tools is accessed
by running the @code{fdroid} script. Run it on its own to get a list of the by running the @code{fdroid} command. Run it on its own to get a list of the
available commands: available sub-commands.
@example
./fdroid
@end example
You can follow any command with @code{--help} to get a list of additional You can follow any command with @code{--help} to get a list of additional
options available for that command. options available for that command.
@example @example
./fdroid update --help fdroid update --help
@end example @end example
@ -385,7 +393,7 @@ following them). In fact, you can standardise all the metadata in a single
command, without changing the functional content, by running: command, without changing the functional content, by running:
@example @example
./fdroid rewritemetadata fdroid rewritemetadata
@end example @end example
The following sections describe the fields recognised within the file. The following sections describe the fields recognised within the file.