summaryrefslogtreecommitdiffstats
path: root/zarb-ml/mageia-dev/2011-July/006961.html
blob: b3a567fc6ca062051f693dccb8cb39f130aed3cb (plain)
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
 <HEAD>
   <TITLE> [Mageia-dev] RFC: gtk-doc proposed changes
   </TITLE>
   <LINK REL="Index" HREF="index.html" >
   <LINK REL="made" HREF="mailto:mageia-dev%40mageia.org?Subject=Re%3A%20%5BMageia-dev%5D%20RFC%3A%20gtk-doc%20proposed%20changes&In-Reply-To=%3CCAJmd%2BxoPecoMkqnn%3DiJhvQg2SMdoEMkMG7ArejeyyvH0OEfYKg%40mail.gmail.com%3E">
   <META NAME="robots" CONTENT="index,nofollow">
   <META http-equiv="Content-Type" content="text/html; charset=us-ascii">
   <LINK REL="Previous"  HREF="006960.html">
   <LINK REL="Next"  HREF="006962.html">
 </HEAD>
 <BODY BGCOLOR="#ffffff">
   <H1>[Mageia-dev] RFC: gtk-doc proposed changes</H1>
    <B>Ahmad Samir</B> 
    <A HREF="mailto:mageia-dev%40mageia.org?Subject=Re%3A%20%5BMageia-dev%5D%20RFC%3A%20gtk-doc%20proposed%20changes&In-Reply-To=%3CCAJmd%2BxoPecoMkqnn%3DiJhvQg2SMdoEMkMG7ArejeyyvH0OEfYKg%40mail.gmail.com%3E"
       TITLE="[Mageia-dev] RFC: gtk-doc proposed changes">ahmadsamir3891 at gmail.com
       </A><BR>
    <I>Fri Jul 22 12:50:39 CEST 2011</I>
    <P><UL>
        <LI>Previous message: <A HREF="006960.html">[Mageia-dev] Finalizing update process
</A></li>
        <LI>Next message: <A HREF="006962.html">[Mageia-dev] RFC: gtk-doc proposed changes
</A></li>
         <LI> <B>Messages sorted by:</B> 
              <a href="date.html#6961">[ date ]</a>
              <a href="thread.html#6961">[ thread ]</a>
              <a href="subject.html#6961">[ subject ]</a>
              <a href="author.html#6961">[ author ]</a>
         </LI>
       </UL>
    <HR>  
<!--beginarticle-->
<PRE>ATM gtk-doc requires dblatex which requires texlive -&gt; texlive-texmf;
due to the outrageous size of texlive-texmf, building packages in
local chroots becomes a bit of pain/burden on my HDD, also each of
texlive and xmltex have I/O intensive postinstall scriptlets.

I see the texlive-texmf issue is being discussed in another thread so
I'll keep this one about gtk-doc; here're a couple of points:
- Some packages have BR gtk-doc but it's redundant:
  o They don't have --enable-gtk-doc passed to ./configure, which
means that BR isn't used at all
  o Most of those packages already bundle html gtk-doc's; is there any
benefit rebuilding those docs when building the package? or should the
gtk-doc BR get dropped in such cases (since no one complained about
those html docs all those years)?

- I am thinking of splitting gtk-doc itself, putting gtkdoc-mkpdf in a
separate sub-package which will require dblatex:
  o AFAICS dblatex is only used for creating PDF's from XML sources,
so only useful for gtkdoc-mkpdf
  o This will result in less HDD grinding due to texlive-texmf and
xmltex being, unnecessarily, pulled in chroots (either local ones or
on the BS). Note that for most of the packages I saw,
--enable-gtk-doc-html is the default (assuming only --enable-gtk-doc
was passed to configure).
  o I don't see any packages with pdf gtk-doc documentation:
  $ urpmf /usr/share/gtk-doc | grep pdf

  gives nothing at all.

So, theoretically, this split shouldn't break any packages (there're
144 SRPMS that have BR gtk-doc and 5 -devel packages that require
gtk-doc). And if any package breaks due to the split, the fix is
simply adding BR gtk-doc-pdf. Of course we can make it more painful
and require that those 149 packages get a test build before the split
is OK'ed...

WDYT?

-- 
Ahmad Samir
</PRE>



















<!--endarticle-->
    <HR>
    <P><UL>
        <!--threads-->
	<LI>Previous message: <A HREF="006960.html">[Mageia-dev] Finalizing update process
</A></li>
	<LI>Next message: <A HREF="006962.html">[Mageia-dev] RFC: gtk-doc proposed changes
</A></li>
         <LI> <B>Messages sorted by:</B> 
              <a href="date.html#6961">[ date ]</a>
              <a href="thread.html#6961">[ thread ]</a>
              <a href="subject.html#6961">[ subject ]</a>
              <a href="author.html#6961">[ author ]</a>
         </LI>
       </UL>

<hr>
<a href="https://www.mageia.org/mailman/listinfo/mageia-dev">More information about the Mageia-dev
mailing list</a><br>
</body></html>