README.Packagers

   1 Notes for package maintainers
   2 -----------------------------
   3
   4
   5 About this file
   6 ---------------
   7 The following notes are intended for package maintainers. These are not
   8 meant as strict rules but only as hints and ideas to make a package
   9 maintainer's life a little bit easier.
  10 So it doesn't make much sense to include this file in any created
  11 packages for general distribution.
  12
  13
  14 Packaging hints
  15 ---------------
  16 If the final file size of the created packaged is a problem, you might
  17 ignore some files and don't package them or put them into a separate
  18 package. This can be easily done (without any further complications)
  19 with the translations files(files in %prefix/share/locale/).
  20 Another possibility is to skip the tags files in the data/ subdirectory.
  21 These are only for auto completion of global symbols. If the files are
  22 missing Geany just doesn't provide these global symbol auto completion
  23 but all other things will work anyways.
  24 You can also skip packaging the full HTML documentation including
  25 images. But if you do so, please include at least the text form of the
  26 manual.
  27 What you shouldn't skip in your package: the filetype.* files in the
  28 data/ subdirectory, these files are important. If they are missing,
  29 Geany still has a fallback mechanism for syntax highlighting (if
  30 filetypes.common is installed) but several other features for certain
  31 filetypes will fail (mainly build support).
  32
  33 For 32 bit builds targeting systems which support large filesystems
  34 (eg XFS) it may be necessary to build with -D_FILE_OFFSET_BITS=64.
  35
  36
  37 Testing your package
  38 --------------------
  39 There are a few things to take care of when you create a package:
  40 - Please check whether you include the following files:
  41   ScintillaLicense.txt, README, manual.txt, COPYING.
  42   ScintillaLicense.txt is the name of the installed file in the doc/
  43   directory. In the source distribution, this file can be found in
  44   scintilla/License.txt.
  45   The file COPYING is the GPLv2 license text and should(have to?) be
  46   included in your package.
  47 - Start Geany after it was installed out of your package. Pass the
  48   command line argument "-v" to see whether Geany complains about
  49   missing files.
  50 - Check whether the help menu item (Help->Help or F1) works and opens
  51   the local installed HTML documentation in your browser (if it opens
  52   the manual on the website you didn't install the HTML manual correctly
  53   and Geany falls back to the online manual).
  54 - Check the About dialog (Help->About) whether it displays the full
  55   GPLv2 license text on the last tab("License").
  56
  57
  58 Feedback
  59 --------
  60 If you have to modify anything to package the Geany sources for your
  61 distribution/target and these changes might be generally useful, please
  62 report your changes to us(the Geany developers) so we can apply them.
  63 Such changes could be removing/adding any files, modifying the autotools
  64 configuration, any modifications to some "meta" files (like
  65 geany.desktop, images/icons, ...) or even if you have to
  66 modify the source code to fix broken compilation or something like this.
  67 Please inform us about changes you made, so maybe you don't have to
  68 change it again with the next release and we can fix it in Geany itself
  69 so others could also benefit from these changes.
  70
  71
  72 Announce your packages
  73 ---------------------
  74 After finishing your package creation, feel free to drop a note on
  75 Geany's mailing list or directly to us (the Geany developers) to
  76 inform us about it. If you wish, we can also add a link on Geany's
  77 website to your package.
  78
  79
  80 Geany announcements
  81 -------------------
  82 Package maintainers are encouraged to subscribe to the Geany mailing
  83 list to stay informed about major changes and of course, new releases.