po/README

   1 NOTES FOR TRANSLATORS
   2 =====================
   3
   4 Introduction
   5 ------------
   6
   7 The dgit source package contains dgit and git-debrebase.
   8 These are useful for a variety of different users and in different
   9 situations.  So there are various documents aimed at various users.
  10
  11 * dgit supports message translation.
  12
  13 * Documentation translation is TBD.
  14
  15 * git-debrebase is currently mostly useful within the Debian project,
  16   but this will change and its translation will then be more
  17   important.  Message translation is mostly not supported right now.
  18
  19 The en_US translation is slightly special.  It is used for testing the
  20 translation machinery, and since the source native language is en_GB,
  21 there is not much other need for the en_US translation.
  22
  23
  24 Translatation priorities
  25 ------------------------
  26
  27   HIGH
  28
  29     dgit-user(1)       How to use dgit to as a downstream or user
  30   *** NB that documentation translation is TBD so you cannot do this yet ***
  31
  32   MEDIUM
  33
  34     messages.pot
  35     dgit.1
  36     dgit-downstream-dsc.7
  37     dgit-sponshorship.7
  38     dgit.7
  39
  40   LOW
  41
  42     dgit-maint-*       } For work within the Debian project
  43     dgit-nmu-simple.7  }  (where one needs good English anyway)
  44
  45     git-debrebase.*    Currently low priority but this will change
  46
  47
  48 Translation organisation
  49 ------------------------
  50
  51   po/messages.pot      all messages from both dgit and git-debrebase
  52   po/LANG.po           translations of those
  53   po/mo                output directory, do not look here
  54
  55   po4a/                documentation (TBD)
  56
  57 Important make targets for translators.
  58 NB all of these are after "cd po/".
  59
  60   make <LANGUAGE>.po   Creates <LANGUAGE>.po so you can start translating,
  61                        or update messages.pot <LANGUAGE>.po.
  62
  63   make all-po          Updates messages.pot from all the sources,
  64                        with new messages, and merges them into
  65                        all the language-specific .po files
  66
  67   make check           Updates everything and then checks everything,
  68                        printing translation statistics.