PackagingGuideMerge

Revision 17 as of 2007-10-18 12:27:05

Clear message

Please add comments, but if you do please add your name next to it.

General

  • Use ToCs everywhere.

Material

Packaging Guide

  1. ["PackagingGuide/Introduction"]
  2. ["PackagingGuide/GettingStarted"]

  3. ["PackagingGuide/Basic"]
    • packaging from scratch, explanation of most important debian/* files

      • Proposal: do introduction, but link to Debian policy counterparts
    • dh_make
      • FIX: -$(MAKE) -i distclean
    • CDBS
    • packaging mistakes
      • Proposal: merge MOTU/Packages/CommonPackagingMistakes* into this page

  4. ["PackagingGuide/PatchSystems"]

    • Proposal: Merge in ["MOTU/School/PatchingSources"]
  5. ["PackagingGuide/Updating"]
  6. ["PackagingGuide/Ubuntu"]
  7. ["PackagingGuide/Bugs"]
  8. ["PackagingGuide/Appendix"]
    • links
      • Proposal: Merge with ["MOTU/Documentation"]
    • chroot docs
      • Proposal: Merge with other chroot docs
    • dh_make example files
    • list of dh_* tools
      • Proposal: automatically generate? (using editmoin)

MOTU Stuff

  • ["MOTU/Packages/CommonPackagingMistakes"]
    • ToC
  • ["MOTU/Packages/DesktopFiles"]
    • contains tools (why source code on the wiki?), explanations, working list
      • ["EmmetHikory"]

        • This is a merge of ~5 previous pages from last cycle
        • no clear home for such small scripts
        • working list is essentially a collaborative blacklist
    • Fix: Make sure people understand that .desktop files need to go upstream, else we don't get translations for them
      • This is stated in second paragraph. Alternate text welcome ["EmmetHikory"]

    • Fix: needs pruning
    • No idea, where to put in the PackagingGuide

      • ["EmmetHikory"]

        • Discussion might be good external to PackagingGuide

        • Instructions could be merged with info on .menu files, .man pages, etc. as part of a new page (needs volunteer)
        • Code could be stuck in a package (or hidden in a wiki attachment & linked)

        • Blacklist probably belongs as part of MOTU coordination pages, external to PackagingGuide

  • ["MOTU/Packages/Merging"]
    • explanations, alternative approach, another approach, links, FIXME, merge tips
    • Fix: needs rigorous pruning and update
    • Proposal: Own Section
  • ["MOTU/Packages/Packaging/Kubuntu"]
    • doc links, default values for default kde packages, patch systems, writing manpages, finding build-depends, building, versioning, .pot files stuff
    • norsetto: .desktop files and shared mime type differences too?
    • Proposal: lots of pruning, keep Kubuntu related material, maybe manpage stuff too
  • norsetto: why not adding a Gnome specific section too? Stuff like dh_gconf, shared mime etc.
  • ["MOTU/Packages/Packaging/Tips"]
    • patching tips
      • Proposal: merge into ["MOTU/School/PatchingSources"]
    • pbuilder
    • CDBS
      • Proposal: merge with ["PackagingGuide/Basic"]
    • Python packaging
      • Proposal: drop and link to appropriate debian docs
    • links Debian docs
  • ["MOTU/Recipes"]
    • just a ToC
    • Proposal: can go away
  • ["MOTU/Recipes/CheckingLibrarySymbols"],
    • checking library symbols on updates
    • Proposal: add to the end of ["PackagingGuide/Updating"]
  • ["MOTU/Recipes/Debdiff"]
  • ["MOTU/Recipes/DebianWatch"]
    • how to use debian/watch

    • Proposal: move to ["PackagingGuide/Basic"]
      • Recommended practices here should match those on ["MOTU/Packages/CommonPackagingMistakes/ChangingTheOrigTarball"]. Both may need updates - ["EmmetHikory"]

  • ["MOTU/Recipes/PackageUpdate"]
  • ["MOTU/Recipes/UseBzrAndBzrBuildpackage"]
    • explanation on how to organise packaging with bzr

    • Proposal: new chapter?
  • ["MOTU/ReferencePackages"]
    • Proposal: add to ["PackagingGuide/Basic"]
  • ["MOTU/School/2005-12-10"]
    • packaging without debhelper and CDBS
    • Proposal: add as a new chapter
  • ["MOTU/School/Merging-and-Syncing"]
    • merging and syncing
    • Proposal: add as a new chapter
  • ["MOTU/School/PackagingBasics"]
    • School sessions, lots of questions answered
    • Proposal: merge into ["PackagingGuide/Basic"]
  • ["MOTU/School/PackagingMistakes"]
    • Proposal: merge into ["PackagingGuide/Basic"]
  • ["MOTU/School/PatchingSources"]
  • ["NewPackageRequirements"]

    • Proposal: merge into ["PackagingGuide/Basic"]
  • ["HowToBuildDebianPackagesFromScratch"]

    • Proposal: merge into ["PackagingGuide/Basic"]
  • norsetto: I would add specific special sections on python, CLI, Java, etc.?

DONE

MOTU stuff

  • ["MOTU/Packages/CommonPackagingMistakes/ChangingTheOrigTarball"]
    • Proposal: make it sound less 'policy'-like
      • If the policy element is removed, it should be made clear that there is a policy (perhaps as a separate document?) ["EmmetHikory"]

  • ["MOTU/Packages/CommonPackagingMistakes/DebianCopyright"]
    • Proposal: should go into ["PackagingGuide/Basic"]
      • Policy aspects are perhaps better kept out of ["PackagingGuide/Basic"]. As with ["MOTU/Packages/CommonPackagingMistakes/ChangingTheOrigTarball"], perhaps these should be separated (in the case of copyright, perhaps merged with ["NewPackageRequirements"] - ["EmmetHikory"]