← Back to branch summary

~launchpad-pqm/launchpad/devel

« back to all changes in this revision

Viewing changes to lib/lp/registry/help/init-series-title-help.html

  • Committer: Launchpad Patch Queue Manager
  • Date: 2011-09-05 09:39:38 UTC
  • mfrom: (13829.4.4 init-help-text-bug-835023)
  • Revision ID: launchpad@pqm.canonical.com-20110905093938-jjcgeshqokwyorm5
[r=julian-edwards][bug=835023] Expand the popup help on the
 +initseries page so it is actually useful.

Show diffs side-by-side

added added

removed removed

Lines of Context:
lib/lp/registry/help/init-series-title-help.html
1
1
<html>
2
2
  <head>
3
 
    <title>Series initialization</title>
 
3
    <title>Series initialisation</title>
4
4
    <link rel="stylesheet" type="text/css"
5
5
          href="/+icing/yui/cssreset/reset.css" />
6
6
    <link rel="stylesheet" type="text/css"
9
9
          href="/+icing/yui/cssbase/base.css" />
10
10
  </head>
11
11
  <body>
12
 
    <h1>There are two ways to initialize a new series:</h1>
 
12
    <h1>There are two ways to initialise a new series:</h1>
13
13
    <ul>
14
14
      <li>A continuation of a distribution with existing series. For example,
15
15
      after the previous series was released you might want to open a new
19
19
      distribution and you want to copy the packages from a series in a
20
20
      different distribution.
21
21
      </li>
 
22
    </ul>
 
23
    <p>
 
24
        In both cases, initialisation is done as a background task after the
 
25
        "Initialize Series" button is pressed.
 
26
    </p>
 
27
 
 
28
     <h3>Continuation series</h3>
 
29
     <p>This will copy all the sources and binaries from the previous
 
30
         series in the distribution.  Its parent series default to the
 
31
         parent series used in the previous series, but they can be changed.
 
32
         This is useful, for example, when the new series has a longer
 
33
         support period and you wish to sync packages from a more stable
 
34
         upstream series.  On an Ubuntu-sized distribution,
 
35
         expect the background task to complete in around 10 minutes.
 
36
     </p>
 
37
     <p>It will also copy all of the settings from the previous series,
 
38
         such as upload permissions and packagesets.</p>
 
39
 
 
40
     <h3>New derived distribution series</h3>
 
41
     <p>Initializing a new distribution is a complicated task. It takes a
 
42
         long time and has a lot of checks. There are various things that
 
43
         you need to specify:
 
44
         <ul>
 
45
           <li>One or more parents to inherit packages from.</li>
 
46
           <li>Which architectures available in parents that you want to use.</li>
 
47
           <li>Which packagesets you want to copy from the parents.</li>
 
48
           <li>Whether to rebuild the copied packages,
 
49
               or copy binaries from the parents.</li>
 
50
         </ul>
 
51
         Normally you can expect the initialisation to complete in minutes
 
52
         if you have less than around 1000 packages, but it will non-linearly
 
53
         increase as the number of copied packages increases, because it has
 
54
         to check that you are not copying conflicting packages.
 
55
     </p>
 
56
 
 
57
     <h3>Pre-initialisation checks and errors</h3>
 
58
     <p>
 
59
       <ul>
 
60
        <li><em>Parent Builds:</em> If the parent has any builds in
 
61
            progress for sources that you are copying,
 
62
            the initialisation will be refused. This is to stop you ending
 
63
            up with the same version binary with contents that differ between
 
64
            parent and child, because the child would rebuild a source
 
65
            that didn't get its binary copied too.
 
66
        </li>
 
67
        <li><em>Pending (Queued) Parent Builds:</em> If the parent has any
 
68
            builds for sources that you are copying that are waiting in the
 
69
            pending-acceptance queues (pending archive admin action),
 
70
            the initialisation will be refused for the same reasons as
 
71
            copying "Parent Builds" above.
 
72
        </li>
 
73
       </ul>
 
74
     </p>
 
75
 
22
76
  </body>
23
77
</html>