blob: 91fafbaf719ef9e8a33305348e07a769f47d13f9 (
plain) (
tree)
|
|
# gns-deb-diff
This script is an effort to automate the documentation of the
differences between gNewSense and Debian.
The present list of differences is documented at the
[gNewSense wiki][1]. Look at the [savannah task #12794][2] for more
info.
See [here for notes about the script][gns-deb-diff-notes].
[1]: http://www.gnewsense.org/Documentation/3/DifferencesWithDebian
[2]: https://savannah.nongnu.org/task/?12794
## Synopsis
$ python gns-deb-diff.py packages-list-file local-packages-directory remote-bzr-url
**defaults**
local-packages-directory = "~/gnewsense/packages-parkes"
remote-bzr-url = "bzr://bzr.savannah.gnu.org/gnewsense/packages-parkes"
`packages-list-file`, is a file which contains a list of package names
that differ from Debian. Look at `packages-parkes.list` file for a
sample.
## Configuration
Specify the `wikiusername`, `passphrase` & the wiki's url at
`src/config/topsecret.txt`.
The `topsecret.txt` file must follow this format:
wikiusername
passphrase
http://wikiurl.ext
## Description
This is what the script does at present:
+ **S1** The script pulls the latest version of the packages, listed
in the `packages-list-file`, from their respective bzr repos.
+ **S2** For packages which contain the `README.gNewSense` file, a
dict of the form `{'pkg': 'package_name', 'Change-Type':
'Added/Removed/Modified', 'Changed-From-Debian': 'one line
description'}` is generated.
The value for keys `Change-Type` & `Changed-From-Debian` is `None`,
if they are not present in the `README.gNewSense` file.
+ **S3** The script puts the names of packages, which doesn't contain
`README.gNewSense` file, into a separate list.
+ **S4** The dicts produced in **S2** is used to generate
MoinMoin marked up table, like
[the one found here][gns-deb-diff-notes].
+ **S5** A wiki page is created using the generated table.
+ **S6** Using XML-RPC, the wiki page is pushed to the wiki.
+ **S7** The list of packages which doesn't contain `README.gNewSense`
is barfed out to stdout.
[gns-deb-diff-notes]: http://www.gnewsense.org/sddhrth/gns-deb-diff-notes
## Contact
**rsiddharth** <rsiddharth@ninthfloor.org> or **gNewSense Hackers** <gnewsense-dev@nongnu.org>
## License
The script is under the [WTFPL version 2 license][3]. See COPYING for more
details. This license is [compatible with GNU GPL][4].
[3]: http://www.wtfpl.net/txt/copying/
[4]: http://www.gnu.org/licenses/license-list.html#WTFPL
|