Subject:
Re: Linux Model is Unix model ? So where's TLDP ?
From:
Emma Jane Hogbin ####@####.####
Date:
7 Mar 2005 16:07:03 -0000
Message-Id: <20050307160735.GA2409@smeagol>
Hello,
(Again, please DO NOT CC me on you replies, I am subscribed to the list
and emails that come in twice tend to get deleted by mistake as I forget
that I've already deleted the first one. Thanks.)
On Mon, Mar 07, 2005 at 04:17:52PM +0100, Mathieu Deschamps wrote:
> + Programmers like documentation (eg. it help coding), one day a programmer +implements something new. He reminds to write doc. in order to share the vision, but +mostly he wants other fellows to pick up his work
In general, most of the authors I've worked with on this project
are not programmers. They are documentation authors, or people who have
had a specific problem using a specific piece of software and have decided
to share their documents with a larger audience. Many are new to writing
documentation. Some "expert" authors think they are too clever to read
the full Author Guide. This is fine. Some "new" authors think they are too
clever to read the full Author Guide as well. However, I also get many
compliments on the Guide, so I guess some people are clever enough to scan
through the table of contents and read the parts that are interesting to
them.
I spent 8 months changing The Author Guide so that it would make sense to
people like me. I *like* reading technical documentation. Ask any of my
friends in real life and they will tell you that I do not read fiction.
I have received a number of compliments on the revised Author Guide, so
clearly it is good for SOME learning styles. It is not perfect for ALL
learning styles. I am not offended if it does not work for you. You do
not like to read long documents in a language you are not familiar with.
THAT'S OK!! The most important thing the Author Guide tells *new* authors
(that is the target audience!) is that the most important thing you can do
as an author is to WRITE YOUR DOCUMENT. It doesn't matter what format they
are in. We will convert it for you. The rest of the document is (mostly)
details for people who LIKE to read details (and I assure you there are
people who do like this--please do not assume that we don't exist).
> +Complete: I feel this community work in closed circuit, in opacity and want to share the +hows and the whys only if you're in for several years, and have time to waste, this is +cathedral policy no a bazaar policy. But I don't want to be too severe maybe that's hard +to stay light and simple and to stand the test of time (10 years, nice).
I don't feel it is a closed circuit. I've been working with the group for
a little while now and I think that the group is open to new ideas. But
the group is also realistic about asking who has the time to implement
these new ideas. Just like programmers "out there" the group asks, "Show
me how this will work for us, don't just tell me what you think I should
build." This is not elitist in my mind.
> +What if I just have to 'Post' my doc on a specific matter (which has, by the way, very few +doc) without being a member of LDP. You see it we don't share the same vision, you and +I don't want to be associed each other anyway, do you ? Ok but where's in the +Unix/Linux model is said I couldn't do both ? ("Post" without being a member I mean, +without eg. having to receved daily tons of mails).
Haha. Sorry, but that did make me laugh. :) Of course you can post your
documents on your own web site without being a part of the LDP. You may
also join the list for a very brief time, submit your document for peer
review, and once it has been accepted you may quit the list again. Most
documents are not accepted on the first post because they are not finished
yet. So you hop on the list, post the doc, hop off and read the archives
through your web browser. I don't think it says anywhere that you CANNOT
do this?
> +This is good to my sense if it renew clean some dirty things. Don't say doc doesn't +attract people, that's a mistake. Having a vade meccum, widely spread, frequently +updated, of a good quality and easy accessable is all Linux users/progs. dream of +provided is display (on the same criterias) the way to learn it. Don't blame anyone +specific and at least not volonteers.
Writing good documentation does not attract a lot of people--but most
people do like to *read* good documentation. Sometimes when I lecture on
it I can fill a room with 30-60 people. But most of the times I get less
than 10. And I am a good public speaker. ;) Not the best, but it is was
I do professionally...
thanks,
emma
--
Emma Jane Hogbin
I18N Coordinator, The Linux Documentation Project
www.tldp.org
--> -->
<type 'exceptions.IOError'> | Python 2.5.2: /usr/bin/python Wed Jul 3 15:47:39 2024 |
A problem occurred in a Python script. Here is the sequence of
function calls leading up to the error, in the order they occurred.
/opt/ezmlm-browse-0.20/main.py in main() |
424
|
425 if path is not None:
|
426 main_path(path)
|
427 else:
|
428 main_form()
|
global main_form = <function main_form at 0x8cc6c6c> |
/opt/ezmlm-browse-0.20/main.py in main_form() |
378 except ImportError:
|
379 die(ctxt, "Invalid command")
|
380 module.do(ctxt)
|
381
|
382 def main():
|
module = <module 'commands.showmsg' from '/opt/ezmlm-browse-0.20/commands/showmsg.pyc'>, module.do = <function do at 0x8ce448c>, global ctxt = {'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'} |
/opt/ezmlm-browse-0.20/commands/showmsg.py in do(ctxt={'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}) |
18 write(html('msg-pager') % ctxt)
|
19 write('<hr>')
|
20 sub_showmsg(ctxt, ctxt[MSGNUM])
|
21 write('<hr>')
|
22 write(html('msg-pager') % ctxt)
|
global sub_showmsg = <function sub_showmsg at 0x8cc61ec>, ctxt = {'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, global MSGNUM = 'msgnum' |
/opt/ezmlm-browse-0.20/globalfns.py in sub_showmsg(ctxt={'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msgnum=8786) |
229 format_timestamp(ctxt, ctxt)
|
230 write(html('msg-header') % ctxt)
|
231 rec_showpart(ctxt, msg, 0)
|
232 write(html('msg-footer') % ctxt)
|
233 ctxt.pop()
|
global rec_showpart = <function rec_showpart at 0x8cc61b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msg = <email.message.Message instance at 0x8d3bc4c> |
/opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x8d3bc4c>, partnum=1) |
205 else:
|
206 for p in part.get_payload():
|
207 partnum = rec_showpart(ctxt, p, partnum+1)
|
208 else:
|
209 write(html('msg-sep') % ctxt)
|
partnum = 1, global rec_showpart = <function rec_showpart at 0x8cc61b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, p = <email.message.Message instance at 0x8d3becc> |
/opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x8d3becc>, partnum=2) |
208 else:
|
209 write(html('msg-sep') % ctxt)
|
210 sub_showpart(ctxt, part)
|
211 return partnum
|
212
|
global sub_showpart = <function sub_showpart at 0x8cc6144>, ctxt = {'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part = <email.message.Message instance at 0x8d3becc> |
/opt/ezmlm-browse-0.20/globalfns.py in sub_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 4, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x8d3becc>) |
164 type = ctxt[TYPE] = part.get_content_type()
|
165 ctxt[FILENAME] = part.get_filename()
|
166 template = html('msg-' + type.replace('/', '-'))
|
167 if not template:
|
168 template = html('msg-' + type[:type.find('/')])
|
global template = <function template at 0x8cbee9c>, global html = <function html at 0x8cbeed4>, type = 'application/pgp-signature', type.replace = <built-in method replace of str object at 0x8d3eb48> |
/opt/ezmlm-browse-0.20/globalfns.py in html(name='msg-application-pgp-signature') |
40
|
41 def html(name):
|
42 return template(name + '.html')
|
43
|
44 def xml(name):
|
global template = <function template at 0x8cbee9c>, name = 'msg-application-pgp-signature' |
/opt/ezmlm-browse-0.20/globalfns.py in template(filename='msg-application-pgp-signature.html') |
31 except IOError:
|
32 if not _template_zipfile:
|
33 _template_zipfile = zipfile.ZipFile(sys.argv[0])
|
34 try:
|
35 f = _template_zipfile.open(n).read()
|
global _template_zipfile = None, global zipfile = <module 'zipfile' from '/usr/lib/python2.5/zipfile.pyc'>, zipfile.ZipFile = <class zipfile.ZipFile at 0x8c57a7c>, global sys = <module 'sys' (built-in)>, sys.argv = ['-c', '/opt/ezmlm-browse-0.20'] |
/usr/lib/python2.5/zipfile.py in __init__(self=<zipfile.ZipFile instance at 0x8d3bf8c>, file='-c', mode='r', compression=0, allowZip64=False) |
337 self.filename = file
|
338 modeDict = {'r' : 'rb', 'w': 'wb', 'a' : 'r+b'}
|
339 self.fp = open(file, modeDict[mode])
|
340 else:
|
341 self._filePassed = 1
|
self = <zipfile.ZipFile instance at 0x8d3bf8c>, self.fp = None, builtin open = <built-in function open>, file = '-c', modeDict = {'a': 'r+b', 'r': 'rb', 'w': 'wb'}, mode = 'r' |
<type 'exceptions.IOError'>: [Errno 2] No such file or directory: '-c'
args =
(2, 'No such file or directory')
errno =
2
filename =
'-c'
message =
''
strerror =
'No such file or directory'