update README and add BUGS

This commit is contained in:
josch 2012-09-26 10:50:48 +02:00
parent c5c422cb59
commit e55ea0e7cc
2 changed files with 35 additions and 35 deletions

8
BUGS Normal file
View file

@ -0,0 +1,8 @@
* only package names are matched, versions are not matched
* Gentoo packages are only mapped to Debian Source packages. This means that
you get a list of Debian source packages as build dependencies. Those
source packages have later to be mapped to binary packages.
* software in Gentoo that's not in Debian
* software in Debian that's not in Gentoo
* different source package splittings
* disjunctive dependencies not handled yet

62
README
View file

@ -6,37 +6,21 @@ Then update your ./portdir with
$ ./update-portdir.sh $ ./update-portdir.sh
Optionally, you can refresh the content of reduced_gen_deps.list by running: At this point, you can already run the following script to get the list of
Debian source packages that can be mapped to Gentoo packages and also have
dependencies that can be dropped in Gentoo:
$ ./gentoo_dep_list.py $ ./find_reduced.py
It writes all source packages with reduced build dependencies plus the build It will print:
dependencies that can be dropped to reduced_gen_deps.list. Execution takes - a list of Debian source packages with dependencies that can be dropped
about 2.5 hours. - a list of Debian packages that cannot be mapped to Gentoo packages
- a list of Gentoo packages that cannot be mapped to Debian packages
Create the file gen_source_pkgs.list by running: Above script depends on the following data files to be present:
$ ./gentoo_pkg_list_raw.sh
This file contains a list of all gentoo packages in your ./portdir
Once you have a filled reduced_gen_deps.list and gen_source_pkgs.list, check
that deb_source_pkgs.list contains all Debian source packages that you are
interested in.
The file deb2gen_mapping.list maps Debian packages to Gentoo packages.
To inspect missing mappings from Debian source packages to Gentoo packages,
run:
$ ./find_pkg_matches.py
It will print you a list of Debian packages that miss a mapping to Gentoo
packages as well as a list of suggestions of Gentoo packages that sound
similar.
Lets summarize the data files that are present by now:
portage - portage sourcecode
* retrieved as a git submodule
portdir - database of ebuild files portdir - database of ebuild files
* retrieved by ./update-portdir.sh * retrieved by ./update-portdir.sh
reduced_gen_deps.list - Gentoo packages with reduced dependencies reduced_gen_deps.list - Gentoo packages with reduced dependencies
@ -49,13 +33,21 @@ deb2gen_mapping.list - mapping of Debian to Gentoo packages
* created manually and/or with the help of * created manually and/or with the help of
./find_pkg_matches.py ./find_pkg_matches.py
At this point, run the following script to get the list of Debian source deb_source_pkgs.list is filled by the user. All other *.list files can be
packages that can be mapped to Gentoo packages and also have dependencies that regenerated by the following scripts:
can be dropped in Gentoo:
$ ./find_reduced.py $ ./gentoo_dep_list.py
It will print: It writes all source packages with reduced build dependencies plus the build
- a list of Debian source packages with dependencies that can be dropped dependencies that can be dropped to reduced_gen_deps.list. Execution takes
- a list of Debian packages that cannot be mapped to Gentoo packages about 2.5 hours.
- a list of Gentoo packages that cannot be mapped to Debian packages
$ ./gentoo_pkg_list_raw.sh
It writes to gen_source_pkgs.list a list of all available Gentoo packages.
$ ./find_pkg_matches.py
Inspects the current content of deb2gen_mapping.list and prints a list of
Debian packages that miss a mapping to Gentoo packages as well as a list of
suggestions of Gentoo packages that sound similar.