Skip to content

Commit 8005eea

Browse files
mitchfoomitchfoo
committed
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments
because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
1 parent d91ff74 commit 8005eea

File tree

142 files changed

+1026
-995
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

142 files changed

+1026
-995
lines changed

‎configure.ac

+1-1
Original file line numberDiff line numberDiff line change
@@ -2197,7 +2197,7 @@ _______EOF
21972197
/**
21982198
* GIMP_API_VERSION:
21992199
*
2200-
* Since: GIMP 2.2
2200+
* Since: 2.2
22012201
**/
22022202
#define GIMP_API_VERSION "$gimp_api_ver"
22032203

‎devel-docs/libgimp/libgimp-docs.sgml

+17-10
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<?xml version="1.0" encoding="UTF-8" ?>
2-
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3-
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
2+
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN'
3+
'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd'>
44

5-
<book id="index" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<book lang="en" id="libgimp-libgimpui" xmlns:xi="http://www.w3.org/2003/XInclude">
66

77
<bookinfo>
88
<title>GIMP Library Reference Manual</title>
@@ -129,26 +129,33 @@
129129
<xi:include href="xml/gimpprocview.xml" />
130130
</part>
131131

132-
<index id="libgimp-index">
132+
<index id="api-index-full">
133133
<title>Index</title>
134+
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
134135
</index>
135-
<index role="GIMP 2.2" id="libgimp-index-new-in-2-2">
136+
<index role="2.2" id="api-index-2-2">
136137
<title>Index of new symbols in GIMP 2.2</title>
138+
<xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
137139
</index>
138-
<index role="GIMP 2.4" id="libgimp-index-new-in-2-4">
140+
<index role="2.4" id="api-index-2-4">
139141
<title>Index of new symbols in GIMP 2.4</title>
142+
<xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
140143
</index>
141-
<index role="GIMP 2.6" id="libgimp-index-new-in-2-6">
144+
<index role="2.6" id="api-index-2-6">
142145
<title>Index of new symbols in GIMP 2.6</title>
146+
<xi:include href="xml/api-index-2.6.xml"><xi:fallback /></xi:include>
143147
</index>
144-
<index role="GIMP 2.8" id="libgimp-index-new-in-2-8">
148+
<index role="2.8" id="api-index-2-8">
145149
<title>Index of new symbols in GIMP 2.8</title>
150+
<xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
146151
</index>
147-
<index role="GIMP 2.10" id="libgimp-index-new-in-2-10">
152+
<index role="2.10" id="api-index-2-10">
148153
<title>Index of new symbols in GIMP 2.10</title>
154+
<xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
149155
</index>
150-
<index role="deprecated" id="libgimp-index-deprecated">
156+
<index role="deprecated" id="api-index-deprecated">
151157
<title>Index of deprecated symbols</title>
158+
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
152159
</index>
153160

154161
</book>

‎devel-docs/libgimpbase/libgimpbase-docs.sgml

+17-14
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<?xml version="1.0" encoding="UTF-8" ?>
2-
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3-
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
2+
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN'
3+
'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd'>
44

5-
<book id="index" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<book lang="en" id="libgimpbase" xmlns:xi="http://www.w3.org/2003/XInclude">
66

77
<bookinfo>
88
<title>GIMP Base Library Reference Manual</title>
@@ -11,7 +11,7 @@
1111
</releaseinfo>
1212
</bookinfo>
1313

14-
<part id="libgimpbase">
14+
<part>
1515
<title>GIMP Base Library</title>
1616
<xi:include href="xml/gimpbaseenums.xml" />
1717
<xi:include href="xml/gimpbasetypes.xml" />
@@ -33,26 +33,29 @@
3333
<xi:include href="xml/gimpvaluearray.xml" />
3434
</part>
3535

36-
<index id="libgimpbase-index">
37-
<title>Index</title>
36+
<index id="api-index-full">
37+
<title id="index-all">Index</title>
38+
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
3839
</index>
39-
<index role="GIMP 2.2" id="libgimpbase-index-new-in-2-2">
40+
<index role="2.2" id="api-index-2-2">
4041
<title>Index of new symbols in GIMP 2.2</title>
42+
<xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
4143
</index>
42-
<index role="GIMP 2.4" id="libgimpbase-index-new-in-2-4">
44+
<index role="2.4" id="api-index-2-4">
4345
<title>Index of new symbols in GIMP 2.4</title>
46+
<xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
4447
</index>
45-
<index role="GIMP 2.6" id="libgimpbase-index-new-in-2-6">
46-
<title>Index of new symbols in GIMP 2.6</title>
47-
</index>
48-
<index role="GIMP 2.8" id="libgimpbase-index-new-in-2-8">
48+
<index role="2.8" id="api-index-2-8">
4949
<title>Index of new symbols in GIMP 2.8</title>
50+
<xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
5051
</index>
51-
<index role="GIMP 2.10" id="libgimpbase-index-new-in-2-10">
52+
<index role="2.10" id="api-index-2-10">
5253
<title>Index of new symbols in GIMP 2.10</title>
54+
<xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
5355
</index>
54-
<index role="deprecated" id="libgimpbase-index-deprecated">
56+
<index role="deprecated" id="api-index-deprecated">
5557
<title>Index of deprecated symbols</title>
58+
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
5659
</index>
5760

5861
</book>

‎devel-docs/libgimpcolor/libgimpcolor-docs.sgml

+19-11
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<?xml version="1.0" encoding="UTF-8" ?>
2-
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3-
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
2+
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN'
3+
'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd'>
44

5-
<book id="index" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<book lang="en" id="libgimpcolor" xmlns:xi="http://www.w3.org/2003/XInclude">
66

77
<bookinfo>
88
<title>GIMP Color Library Reference Manual</title>
@@ -11,7 +11,7 @@
1111
</releaseinfo>
1212
</bookinfo>
1313

14-
<part id="libgimpcolor">
14+
<part>
1515
<title>GIMP Color Library</title>
1616
<xi:include href="xml/gimprgb.xml" />
1717
<xi:include href="xml/gimphsv.xml" />
@@ -21,29 +21,37 @@
2121
<xi:include href="xml/gimpadaptivesupersample.xml" />
2222
<xi:include href="xml/gimpbilinear.xml" />
2323
<xi:include href="xml/gimpcairo.xml" />
24+
<xi:include href="xml/gimppixbuf.xml" />
2425
<xi:include href="xml/gimplcms.xml" />
2526
</part>
2627

27-
<index id="libgimpcolor-index">
28+
<index id="api-index-full">
2829
<title>Index</title>
30+
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
2931
</index>
30-
<index role="GIMP 2.2" id="libgimpcolor-index-new-in-2-2">
32+
<index role="2.2" id="api-index-2-2">
3133
<title>Index of new symbols in GIMP 2.2</title>
34+
<xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
3235
</index>
33-
<index role="GIMP 2.4" id="libgimpcolor-index-new-in-2-4">
36+
<index role="2.4" id="api-index-2-4">
3437
<title>Index of new symbols in GIMP 2.4</title>
38+
<xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
3539
</index>
36-
<index role="GIMP 2.6" id="libgimpcolor-index-new-in-2-6">
40+
<index role="2.6" id="api-index-2-6">
3741
<title>Index of new symbols in GIMP 2.6</title>
42+
<xi:include href="xml/api-index-2.6.xml"><xi:fallback /></xi:include>
3843
</index>
39-
<index role="GIMP 2.8" id="libgimpcolor-index-new-in-2-8">
44+
<index role="2.8" id="api-index-2-8">
4045
<title>Index of new symbols in GIMP 2.8</title>
46+
<xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
4147
</index>
42-
<index role="GIMP 2.10" id="libgimpcolor-index-new-in-2-10">
48+
<index role="2.10" id="api-index-2-10">
4349
<title>Index of new symbols in GIMP 2.10</title>
50+
<xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
4451
</index>
45-
<index role="deprecated" id="libgimpcolor-index-deprecated">
52+
<index role="deprecated" id="api-index-deprecated">
4653
<title>Index of deprecated symbols</title>
54+
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
4755
</index>
4856

4957
</book>

‎devel-docs/libgimpconfig/libgimpconfig-docs.sgml

+16-10
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<?xml version="1.0" encoding="UTF-8" ?>
2-
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3-
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
2+
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN'
3+
'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd'>
44

5-
<book id="index" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<book lang="en" id="libgimpconfig" xmlns:xi="http://www.w3.org/2003/XInclude">
66

77
<bookinfo>
88
<title>GIMP Config Library Reference Manual</title>
@@ -11,7 +11,7 @@
1111
</releaseinfo>
1212
</bookinfo>
1313

14-
<part id="libgimpconfig">
14+
<part>
1515
<title>GIMP Config Library</title>
1616

1717
<chapter id="libgimpconfig-hierarchy">
@@ -31,23 +31,29 @@
3131
<xi:include href="xml/gimpcolorconfig.xml" />
3232
</part>
3333

34-
<index id="libgimpconfig-index">
34+
<index id="api-index-full">
3535
<title>Index</title>
36+
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
3637
</index>
37-
<index role="GIMP 2.4" id="libgimpconfig-index-new-in-2-4">
38+
<index role="2.4" id="api-index-2-4">
3839
<title>Index of new symbols in GIMP 2.4</title>
40+
<xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
3941
</index>
40-
<index role="GIMP 2.6" id="libgimpconfig-index-new-in-2-6">
42+
<index role="2.6" id="api-index-2-6">
4143
<title>Index of new symbols in GIMP 2.6</title>
44+
<xi:include href="xml/api-index-2.6.xml"><xi:fallback /></xi:include>
4245
</index>
43-
<index role="GIMP 2.8" id="libgimpconfig-index-new-in-2-8">
46+
<index role="2.8" id="api-index-2-8">
4447
<title>Index of new symbols in GIMP 2.8</title>
48+
<xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
4549
</index>
46-
<index role="GIMP 2.10" id="libgimpconfig-index-new-in-2-10">
50+
<index role="2.10" id="api-index-2-10">
4751
<title>Index of new symbols in GIMP 2.10</title>
52+
<xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
4853
</index>
49-
<index role="deprecated" id="libgimpconfig-index-deprecated">
54+
<index role="deprecated" id="api-index-deprecated">
5055
<title>Index of deprecated symbols</title>
56+
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
5157
</index>
5258

5359
</book>

‎devel-docs/libgimpmath/libgimpmath-docs.sgml

+14-15
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<?xml version="1.0" encoding="UTF-8" ?>
2-
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3-
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
2+
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN'
3+
'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd'>
44

5-
<book id="index" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<book lang="en" id="libgimpmath" xmlns:xi="http://www.w3.org/2003/XInclude">
66

77
<bookinfo>
88
<title>GIMP Math Library Reference Manual</title>
@@ -11,34 +11,33 @@
1111
</releaseinfo>
1212
</bookinfo>
1313

14-
<part id="libgimpmath">
14+
<part>
1515
<title>GIMP Math Library</title>
1616
<xi:include href="xml/gimpmath.xml" />
1717
<xi:include href="xml/gimpmatrix.xml" />
1818
<xi:include href="xml/gimpvector.xml" />
1919
<xi:include href="xml/gimpmd5.xml" />
2020
</part>
2121

22-
<index id="libgimpmath-index">
22+
<index id="api-index-full">
2323
<title>Index</title>
24+
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
2425
</index>
25-
<index role="GIMP 2.2" id="libgimpmath-index-new-in-2-2">
26-
<title>Index of new symbols in GIMP 2.2</title>
27-
</index>
28-
<index role="GIMP 2.4" id="libgimpmath-index-new-in-2-4">
26+
<index role="2.4" id="api-index-2-4">
2927
<title>Index of new symbols in GIMP 2.4</title>
28+
<xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
3029
</index>
31-
<index role="GIMP 2.6" id="libgimpmath-index-new-in-2-6">
32-
<title>Index of new symbols in GIMP 2.6</title>
33-
</index>
34-
<index role="GIMP 2.8" id="libgimpmath-index-new-in-2-8">
30+
<index role="2.8" id="api-index-2-8">
3531
<title>Index of new symbols in GIMP 2.8</title>
32+
<xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
3633
</index>
37-
<index role="GIMP 2.10" id="libgimpmath-index-new-in-2-10">
34+
<index role="2.10" id="api-index-2-10">
3835
<title>Index of new symbols in GIMP 2.10</title>
36+
<xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
3937
</index>
40-
<index role="deprecated" id="libgimpmath-index-deprecated">
38+
<index role="deprecated" id="api-index-deprecated">
4139
<title>Index of deprecated symbols</title>
40+
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
4241
</index>
4342

4443
</book>

‎devel-docs/libgimpmodule/libgimpmodule-docs.sgml

+12-17
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<?xml version="1.0"?>
2-
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3-
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
2+
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN'
3+
'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd'>
44

5-
<book id="index" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<book lang="en" id="libgimpmodule" xmlns:xi="http://www.w3.org/2003/XInclude">
66

77
<bookinfo>
88
<title>GIMP Module Library Reference Manual</title>
@@ -11,32 +11,27 @@
1111
</releaseinfo>
1212
</bookinfo>
1313

14-
<part id="libgimpmodule">
14+
<part>
1515
<title>GIMP Module Library</title>
1616
<xi:include href="xml/gimpmodule.xml" />
1717
<xi:include href="xml/gimpmoduledb.xml" />
1818
</part>
1919

20-
<index id="libgimpmodule-index">
20+
<index id="api-index-full">
2121
<title>Index</title>
22+
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
2223
</index>
23-
<index role="GIMP 2.2" id="libgimpmodule-index-new-in-2-2">
24-
<title>Index of new symbols in GIMP 2.2</title>
25-
</index>
26-
<index role="GIMP 2.4" id="libgimpmodule-index-new-in-2-4">
27-
<title>Index of new symbols in GIMP 2.4</title>
28-
</index>
29-
<index role="GIMP 2.6" id="libgimpmodule-index-new-in-2-6">
30-
<title>Index of new symbols in GIMP 2.6</title>
31-
</index>
32-
<index role="GIMP 2.8" id="libgimpmodule-index-new-in-2-8">
24+
<index role="2.8" id="api-index-2-8">
3325
<title>Index of new symbols in GIMP 2.8</title>
26+
<xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
3427
</index>
35-
<index role="GIMP 2.10" id="libgimpmodule-index-new-in-2-10">
28+
<index role="2.10" id="api-index-2-10">
3629
<title>Index of new symbols in GIMP 2.10</title>
30+
<xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
3731
</index>
38-
<index role="deprecated" id="libgimpmodule-index-deprecated">
32+
<index role="deprecated" id="api-index-deprecated">
3933
<title>Index of deprecated symbols</title>
34+
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
4035
</index>
4136

4237
</book>

0 commit comments

Comments
 (0)