<!ENTITY % dynamicdata SYSTEM "dynamic.ent" > %dynamicdata;
<!-- CVS revision of this document -->
- <!ENTITY cvs-rev "$Revision: 1.335 $">
+ <!ENTITY cvs-rev "$Revision: 1.336 $">
<!-- if you are translating this document, please notate the CVS
revision of the original developer's reference in cvs-en-rev -->
<sect1 id="bpp-upstream-info">
<heading>Upstream home page</heading>
<p>
-We recommend that you add the URL for the package's home page to the
-package description in <file>debian/control</file>. This information
-should be added at the
-end of description, using the following format:
-
-<example> .
- Homepage: http://some-project.some-place.org/</example>
-
-Note the spaces prepending the line, which serves to break the lines
-correctly. To see an example of how this displays, see <url
-id="&url-eg-desc-upstream-info;">.
- <p>
-If there is no home page for the software, this should naturally be
-left out.
- <p>
-Note that we expect this field will eventually be replaced by a proper
-<file>debian/control</file> field understood by <prgn>dpkg</prgn> and
-<tt>&packages-host;</tt>. If you don't want to bother migrating the
-home page from the description to this field, you should probably wait
-until that is available.
- Please make sure that this line matches the regular expression
- <tt>/^ Homepage: [^ ]*$/</tt>,
- as this allows <file>packages.debian.org</file> to parse it correctly.</p>
+We recommend that you add the URL for the package's home page in the
+<tt>Homepage</tt> field of the <tt>Source</tt> section in
+<file>debian/control</file>. Adding this information in the package
+description itself is considered deprecated.
</sect1>
<sect1 id="bpp-vcs">
repository of the <package>vim</package> package is shown. Note how the
URL is in the <tt>svn://</tt> scheme (instead of <tt>svn+ssh://</tt>) and
how it points to the <file>trunk/</file> branch. The use of the
-<tt>Vcs-Browser</tt> field described above is also shown.
+<tt>Vcs-Browser</tt> and <tt>Homepage</tt> fields described above is
+also shown.
<example>
Source: vim
Section: editors
<snip>
Vcs-Svn: svn://svn.debian.org/svn/pkg-vim/trunk/packages/vim
Vcs-Browser: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim
+ Homepage: http://www.vim.org
</example>
</sect1>
</sect>