Editing User:Jaffa/mud design

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

With the new [[Extras repository process definition|extras process]], [http://mud-builder.garage.maemo.org/ mud-builder] should be re-focused<ref>[https://garage.maemo.org/pipermail/mud-builder-users/2008-June/000255.html MUD Direction?], ''Andrew Flegg'', 26 June 2008</ref> and re-invigorated to help packaging in accordance with the Maemo Packaging Policy<ref>[https://maemo.org/forrest-images/pdf/maemo-policy.pdf Maemo Packaging Policy], ''Eero Tamminen'', 28 May 2008</ref> and [[Uploading to Extras-devel]].

== Requirements ==
* Taking an upstream project (from somewhere) and applying zero or more patches for Maemo.
** Automate creation of projects.
** Take URL of upstream source deb info page (fish out .dsc, .diff.gz and .tar.gz).
** Take URL of upstream tarball <strike>done</strike>
* Provide easy in-life management, e.g. changelogs and maintaining the patch.
* Proper debification and Maemo additions (like <code>Section: user/</code> and the icon) <strike>done</strike>
* Conformant with the Maemo Packaging Policy:
** Any package patched, or not from a existing deb source, needs to have a ''maemo'' version suffix.
*** For example, if the base version is 7.0, the package version from mud should be '''7.0-0maemo1''' for the first upload, '''7.0-0maemo2''' for the second, etc.
*** If the upstream package comes from Debian (with version 3.5-7) and is unpatched, the package uploaded from mud is also '''3.5-7'''.
*** If the upstream package comes from Debian (with version 3.5-7) and ''is'' patched, the package uploaded from mud is '''3.5-7maemo1''' for the first upload, '''3.5-7maemo2''' for the second, etc.
** Warnings should be given when uploading a package with "Section: user/(.*)" where <code>$1</code> is not in the accepted list.
** It is an error to try and upload a package with no description.
* Auto-sign & upload to ...-extras-builder in one-step
** Use scp to upload all the files, uploading .changes and .dsc ''last'', to avoid auto-builder issues (driven by .dsc files and [https://bugs.maemo.org/show_bug.cgi?id=3354 #3354])
* Auto-determine Build-Depends <strike>r234</strike>

== Examples ==
Create new packages within mud's <code>packages/</code> directory. They can then be manipulated, built, edited and uploaded:
 mud create http://packages.debian.org/source/lenny/cal
 mud create http://packages.ubuntu.com/source/hardy/libgee
 mud create http://download.gnome.org/sources/vala/0.3/vala-0.3.4.tar.bz2
 mud create new-package

Take a package (for example, from the upstream deb source - in the above case - Ubuntu Hardy), build it; sign it and upload it to diablo-extras-builder:
 mud build libgee
 mud upload libgee

Typical workflow for getting a package, unpacking the source, editing it, checking the result and then cleaning out the working copy:
 mud get vala
 mud compile vala
 ...
 mud diff vala
 ...
 mud compile vala
 mud clean vala

== Workflow ==
Use quilt<ref>[http://www.suse.de/~agruen/quilt.pdf "Introduction to Quilt", ''Andreas Gr¨unbacher'', June 12 2005</ref>?

TBC

== Internals ==
Awaiting consensus on usage.

=== Package structure ===
Instead of having <code>''package''.xml</code>, <code>patches/''package''.patch</code> and <code>icon/''package''</code>, v2.0 of mud should have more consolidation:

''package''/
   info.xml - required
   ''package''.png - optional icon, used if -nn not present
   ''package''-26.png - optional, if present copied to right place
   ''package''-64.png - optional, if present copied to right place
   ''package''.desktop - if present, auto-copied to right place
   ''package''.service - if present, auto-copied to right place
   extras.xml- optional specification of file destinations, modes, owners, groups etc.
   extras/ - copied to ''build-dir''/mud-extras
   patches/ - contains quilt patch set
     ...
     ...

Icon files, desktop and service files are auto-considered part of 'extras' with implicit rules for their destination.

<pre>
&lt;extras&gt;
  &lt;file name="foo.sh"&gt;
    &lt;destination path="/usr/bin/foo.sh" [mode="auto|0755" ][owner="..."][group="..." ]/&gt;
    &lt;destination path="/usr/bin/foo2.sh" /&gt;
  &lt;/file&gt;
&lt;/extras&gt;
</pre>

Mode is optional (set to 0644 if unspecified, unless the file starts #!). Owner and group default to root. <code>install -D</code> lines are auto-added to end of <code>debian/rules:install</code>.

=== Install steps ===
# Add extras and extras-devel to /etc/apt/sources.list.d in Scratchbox
# Install mud.
# Create <code>~/.mudrc</code> containing garage username and gnupg key to use

For example:
 /scratchbox/login
 for j in '' '-src'; do for i in '' '-devel'; do
   echo "deb$j http://repository.maemo.org/extras$i diablo free non-free" >>/etc/apt/sources.list.d/extras-repo.list
 done; done
 apt-get update && apt-get install mud
 cat >~/.mudrc <<EOM
 USERNAME=jaffa
 GPG_KEY=FC11178D
 EOM

=== Extras package ===
mud should be in Extras, and needs dependencies on:
* xsltproc
* devscripts
* gnupg
* sharutils

Suggests:
* imagemagick

== Notes ==

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Retrieved from "http://wiki.maemo.org/User:Jaffa/mud_design"

Personal tools

Navigation

Views

Editing User:Jaffa/mud design

@@ Line 45: / Line 45: @@
 == Internals ==
+Awaiting consensus on usage.
 === Package structure ===
 Instead of having <code>''package''.xml</code>, <code>patches/''package''.patch</code> and <code>icon/''package''</code>, v2.0 of mud should have more consolidation:
-  ''package''.pkg/
+  ''package''/
-    mud.xml - required
+    info.xml - required
     ''package''.png - optional icon, used if -nn not present
     ''package''-26.png - optional, if present copied to right place
@@ Line 58: / Line 59: @@
     extras.xml- optional specification of file destinations, modes, owners, groups etc.
     extras/ - copied to ''build-dir''/mud-extras
-     ...
     patches/ - contains quilt patch set
       ...