File: gap-policy.sgml

package info (click to toggle)
gap 4r7p5-2
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 29,272 kB
  • ctags: 7,129
  • sloc: ansic: 107,802; xml: 46,868; sh: 3,548; perl: 2,329; makefile: 740; python: 94; asm: 62; awk: 6
file content (79 lines) | stat: -rw-r--r-- 2,696 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
<!doctype debiandoc system>

<!--
 Debian GAP Policy
 Copyright (C) 2004-2014 Bill Allombert.
 released under the terms of the GNU
 General Public License, version 2 or (at your option) any later.
 -->

<book>

<title>Debian GAP Policy
<author>Bill Allombert <email/ballombe@debian.org/
<version>version 0.1, <date>

<abstract>

This unofficial policy describes the conventions that Debian packages of GAP
(<httpsite>http://www.gap-system.org</>) components must follows to get along
nicely with the gap-core package and others.
</abstract>

<toc sect>

<chapt> Convention used in this policy
<p>
Since GAP and Debian have a different concept of package, we will
use the following conventions:
<enumlist>
<item><var/$pkg/ denote the name of the GAP package as stated on the 
GAP website.
<item><var/$package/ denote the name of your Debian package.
</enumlist>

<chapt> Package name
<p>
Name of GAP packages (<var/$pkg/) are usually short and cryptic, like
<tt/ctbllib/.  You should choose a more verbose name (<var/$package/) like
gap-character-tables.
<enumlist>
<item> <var/$package/ must start by <tt/gap-/.
<item> Package must provide <tt/gap-pkg-$pkg/ so GAP users can do
<prgn/apt-get gap-pkg-$pkg/ without having to guess <var/$package/.
</enumlist>

<chapt> Installation
<p>
GAP packages should be installed in the <file>/usr/share/gap/pkg/$pkg</file>
directory.  Architecture dependent part of the package should go to
<file>/usr/lib/gap/pkg/$pkg</file>. You can provide symlinks if this is
necessary.
<p> If your package include large (say around 1MB) datasets (library of
groups, etc...), you should compress them (after checking GAP is able to
automatically uncompress them) with <prgn/gzip --best/ to save diskspace. Try
to not compress source code files (<tt/.g/ files) if possible.  

<chapt> Global GAP workspace
<p> To allow GAP to start faster, Debian provides a global workspace file
in <file>/var/lib/gap/workspace.gz</file>. This file is managed by 
<prgn/update-gap-workspace/. If this file exists, it will be automatically
updated whenever a Debian GAP package is installed or upgraded, through
a gap-core dpkg trigger.

<chapt> GAP2DEB
<p>
The GAP script <tt/gap2deb/ can be used to generate a basic <file>debian</file>
directory from a <file>PackageInfo.g</file> file. It must be run in the
package directory.

<chapt> Documentation
<p>
GAP packages come usually with extensive documentation.
<enumlist>
<item> TeX files used by the online help system must be shipped.
<item> Documentation must be shipped preferably in <tt/html/ and <tt/pdf/.
<item> Ship the file <file/manual.toc/ compressed. This enable
<tt/SetHelpviewer()/ to function properly.
</enumlist>
</book>