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
114
115
116
117
118
119
120
121
122
123
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE> [Mageia-dev] Suggest summary documentation of Mageia perl routines
</TITLE>
<LINK REL="Index" HREF="index.html" >
<LINK REL="made" HREF="mailto:mageia-dev%40mageia.org?Subject=Re%3A%20%5BMageia-dev%5D%20Suggest%20summary%20documentation%20of%20Mageia%0A%09perl%09routines&In-Reply-To=%3C4E549AD7.9000609%40laposte.net%3E">
<META NAME="robots" CONTENT="index,nofollow">
<META http-equiv="Content-Type" content="text/html; charset=us-ascii">
<LINK REL="Previous" HREF="007470.html">
<LINK REL="Next" HREF="007482.html">
</HEAD>
<BODY BGCOLOR="#ffffff">
<H1>[Mageia-dev] Suggest summary documentation of Mageia perl routines</H1>
<B>andre999</B>
<A HREF="mailto:mageia-dev%40mageia.org?Subject=Re%3A%20%5BMageia-dev%5D%20Suggest%20summary%20documentation%20of%20Mageia%0A%09perl%09routines&In-Reply-To=%3C4E549AD7.9000609%40laposte.net%3E"
TITLE="[Mageia-dev] Suggest summary documentation of Mageia perl routines">andr55 at laposte.net
</A><BR>
<I>Wed Aug 24 08:31:51 CEST 2011</I>
<P><UL>
<LI>Previous message: <A HREF="007470.html">[Mageia-dev] Suggest summary documentation of Mageia perl routines
</A></li>
<LI>Next message: <A HREF="007482.html">[Mageia-dev] Suggest summary documentation of Mageia perl routines
</A></li>
<LI> <B>Messages sorted by:</B>
<a href="date.html#7477">[ date ]</a>
<a href="thread.html#7477">[ thread ]</a>
<a href="subject.html#7477">[ subject ]</a>
<a href="author.html#7477">[ author ]</a>
</LI>
</UL>
<HR>
<!--beginarticle-->
<PRE>Thierry Vignaud a écrit :
><i> On 23 August 2011 15:46, Jerome Quelin<<A HREF="https://www.mageia.org/mailman/listinfo/mageia-dev">jquelin at gmail.com</A>> wrote:
</I>>><i> On 11/08/23 15:40 +0200, Thierry Vignaud wrote:
</I>>>><i> Which one jquelin is reffering to?
</I>>><i>
</I>>><i> none. i'm maintaining perl& perl modules for mageia, but am not a drak*
</I>>><i> contributor.
</I>><i>
</I>><i> OK, I was mistaken by "a post by jquelin reminded me of something that
</I>><i> would be nice to see"
</I>><i>
</I>my fault ... a comment he made about something unrelated reminded me of this idea.
I've been wanting to contribute to drak* for some time.
(but readily distracted by other things)
Something like :
----
routine: foo(parm1, parm2, ...)
path: .../{filename}
purpose: ...
parm1 = ...
parm2 = ...
----
for each routine, without any details of internals.
(Essentially, what does the black box do.)
The path is useful if more than one function has the same name, as well as
examining internals if wanted.
Basically I was thinking of Mageia-specific perl routines.
I started deciphering rpmdrake back on mdv, and did a cludge to rearrange the
main screen, but not being familiar with the invoked routines was a big
handicap for doing more.
You gave me some useful tips at the time.
I could make a script to extract the routine names + paths, but at least one
line of comment in the perl code right after the routine name would be very
useful. (It could be just before - but that would be harder to extract.)
--
André
</PRE>
<!--endarticle-->
<HR>
<P><UL>
<!--threads-->
<LI>Previous message: <A HREF="007470.html">[Mageia-dev] Suggest summary documentation of Mageia perl routines
</A></li>
<LI>Next message: <A HREF="007482.html">[Mageia-dev] Suggest summary documentation of Mageia perl routines
</A></li>
<LI> <B>Messages sorted by:</B>
<a href="date.html#7477">[ date ]</a>
<a href="thread.html#7477">[ thread ]</a>
<a href="subject.html#7477">[ subject ]</a>
<a href="author.html#7477">[ 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>
|