Changeset 4583

Timestamp:

May 4, 2017, 2:31:44 PM (3 years ago)

Author:

Juanma

Message:

updated README

Location:

devtools/desktop_to_xml

Files:

• README (modified) (2 diffs)
• desktop_to_xml.sh (modified) (1 diff)

devtools/desktop_to_xml/README

@@ -5 +5 @@
 ./desktop_to_xml svn_dir
 
-This tool needs the lliurex-artwork-defaults dir from svn in the same dir as svn_dir
+This tool needs the vibrancy-colors dir from svn in the same dir as svn_dir
 Example:
 /home
@@ -11 +11 @@
                 /svn
                         /svn_dir
-                        /lliurex-artwork-defaults
+                        /vibrancy-colors
 
+Running
+---------
+There're many kinds of packages "out in the wild" so this script tries to adapt to all of those.
+The script will ask the user when:
+ - 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.
+ - 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
+ - There's two or more lines in the selected install file: For the same reason the script needs to ask for the right dir.
 
+ Will warn us when:
+ - The package uses an old rules file. 
+ - The vibrancy-colors dir is missing
+
+ Will abort if:
+ - Icon can't be found. Only svg ones are valid, the script will not use icons in png or any other format but svg.
+ - Missed svn dir
+
+Finally, if no errors are detected, the script populates the llx-resource dir and updates the rules file for add the llxsrc helper. 
+
+CONSIDERATIONS
+-------------
+Some packages are really old and have some "strange things", like gif icons, that have to be reworked.
+If the package has an old rules file it's convenient to update it to the new format.
+If 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...)

devtools/desktop_to_xml/desktop_to_xml.sh

@@ -18 +18 @@
 msg_desktop_updated="\nDesktop file updated.\n"
 msg_icon_found="Icon %s found.\nGenerating llx-resources dir\n"
-msg_icon_not_found="\nNo icon named %s found on dirs %s, %s or %s\nRemember that the icon must be in SVG format and no in PNG or other image format\n"
+msg_icon_not_found="\nNo icon named %s found on dirs %s, %s or %s\nRemember that the icon must be in SVG format and no in PNG or other image format\nOPERATION ABORTED\n"
 msg_icon_location_info="\nPlease add %s as svg to %s and relaunch this program or use the llxsrc debhelper. Until then the app will not be included in our software store.\n"
 msg_icon_exists="\nIcon package found on the right location. Checking if llxsrc helper exists in rules\n"