source: devtools/desktop_to_xml/README @ 4583

Last change on this file since 4583 was 4583, checked in by Juanma, 3 years ago

updated README

File size: 1.6 KB
Line 
1This tool adapts a svn directory for the lliurex-store.
2Generates the xml appinfo file and adds the dir "llx-resources" needed for the llxsrc debhelper to work. Also modifies the desktop file removing some mistakes.
3
4Usage:
5./desktop_to_xml svn_dir
6
7This tool needs the vibrancy-colors dir from svn in the same dir as svn_dir
8Example:
9/home
10        /user
11                /svn
12                        /svn_dir
13                        /vibrancy-colors
14
15Running
16---------
17There're many kinds of packages "out in the wild" so this script tries to adapt to all of those.
18The script will ask the user when:
19 - The control file has two or more packages: In this case the script needs to know which is the package name that we're looking for.
20 - There's two or more install files in the debian dir: The script needs the install file who has the dirs with the desktop file
21 - There's two or more lines in the selected install file: For the same reason the script needs to ask for the right dir.
22
23 Will warn us when:
24 - The package uses an old rules file.
25 - The vibrancy-colors dir is missing
26
27 Will abort if:
28 - Icon can't be found. Only svg ones are valid, the script will not use icons in png or any other format but svg.
29 - Missed svn dir
30
31Finally, if no errors are detected, the script populates the llx-resource dir and updates the rules file for add the llxsrc helper.
32
33CONSIDERATIONS
34-------------
35Some packages are really old and have some "strange things", like gif icons, that have to be reworked.
36If the package has an old rules file it's convenient to update it to the new format.
37If the operation fails it's better to remove the dir and "re-co" from svn to avoid unexpected behaviors of the script (that should no pass but just in case...)
Note: See TracBrowser for help on using the repository browser.