Not quite sure where to post this, so I thought I'd send it here. I've just started working with Mailman and when I started to print out the administrator commands with --help I noticed, ummm, a bit of, well, shall we say, inconsistency. :) Now I'm not a python programmer (sigh, another to learn?), but in looking through the files it looks like it would be fairly simple to edit them to a consistent standard.
I want to contribute back and this is something I can do. Who and how should I submit these changes? I think a lot of the text descriptions could also be cleaned up and used on the web page, so I'd be happy to do that as well.
Russ Pagenkopf
At 9:39 PM -0900 2004-11-11, Russ Pagenkopf wrote:
I want to contribute back and this is something I can do. Who and how should I submit these changes?
Tokio Kikuchi is now in charge of the 2.1-maint branch. He has
requested updates for the Danish translations be sent to him in tar format, and I presume he'd want the same for your work.
His e-mail address is tkikuchi@is.kochi-u.ac.jp.
I think a lot of the text descriptions
could also be cleaned up and used on the web page, so I'd be happy to do that as well.
That's a different process. To update that stuff requires access
to the webserver and using CVS. You'd have to ask Barry about that.
-- Brad Knowles, brad@stop.mail-abuse.org
"Those who would give up essential Liberty, to purchase a little temporary Safety, deserve neither Liberty nor Safety."
-- Benjamin Franklin (1706-1790), reply of the Pennsylvania
Assembly to the Governor, November 11, 1755
SAGE member since 1995. See http://www.sage.org/ for more info.
Hi,
Brad Knowles wrote:
At 9:39 PM -0900 2004-11-11, Russ Pagenkopf wrote:
I want to contribute back and this is something I can do. Who and how should I submit these changes?
Tokio Kikuchi is now in charge of the 2.1-maint branch. He has
requested updates for the Danish translations be sent to him in tar format, and I presume he'd want the same for your work.
His e-mail address is tkikuchi@is.kochi-u.ac.jp.
Well, patches should be uploaded to SourceForge tracker first: http://sourceforge.net/tracker/?group_id=103&atid=300103
In the case of translations, some champions have the privilege of accessing their language area in the CVS. Barry and also most recently I will take care for the others.
I think a lot of the text descriptions
could also be cleaned up and used on the web page, so I'd be happy to do that as well.
That's a different process. To update that stuff requires access to
the webserver and using CVS. You'd have to ask Barry about that.
-- Tokio Kikuchi, tkikuchi@ is.kochi-u.ac.jp http://weather.is.kochi-u.ac.jp/
On Nov 12, 2004, at 1:39 AM, Russ Pagenkopf wrote:
Not quite sure where to post this, so I thought I'd send it here. I've just started working with Mailman and when I started to print out the administrator commands with --help I noticed, ummm, a bit of, well, shall we say, inconsistency. :) Now I'm not a python programmer (sigh, another to learn?), but in looking through the files it looks like it would be fairly simple to edit them to a consistent standard.
I want to contribute back and this is something I can do. Who and how should I submit these changes? I think a lot of the text descriptions could also be cleaned up and used on the web page, so I'd be happy to do that as well.
I started working on this, but I'd *love* to have someone else do it.
If you're bored, you can finish up the man pages I'd been writing for
each command. I also started doing the web stuff, but I realise quite
a lot of it could use more work.
I'm running out the door at the moment, but I'll get in touch with you to let you know exactly what I *have* been doing. And if Tokio doesn't mind, you can deal with me as the documentation person and save him the trouble of fussing over that part of things. I accept patches to documentation if need be. :)
Terri
On Nov 12, 2004, at 1:39 AM, Russ Pagenkopf wrote:
Not quite sure where to post this, so I thought I'd send it here. I've just started working with Mailman and when I started to print out the administrator commands with --help I noticed, ummm, a bit of, well, shall we say, inconsistency. :) Now I'm not a python programmer (sigh, another to learn?), but in looking through the files it looks like it would be fairly simple to edit them to a consistent standard.
I want to contribute back and this is something I can do. Who and how should I submit these changes? I think a lot of the text descriptions could also be cleaned up and used on the web page, so I'd be happy to do that as well.
Okey dokey. Sorry I didn't get right back to you.
So I would *love* it if you did revisions on the --help for the commands. I don't know if you were planning on changing any code or just the --help output, but do be super-careful about changing any of the actual functionality -- basically, we'd prefer not to change the way anything works so upgrades don't break people's automated scripts, but if you add additional syntaxes for the same thing, that's okay.
I've been working on man pages, and the lack of consistency was getting on my nerves, but I hadn't had time to go through and do anything about it. If you've got more time once you've got the --help documentation made consistent, I'd really love it if you could update/create man pages for the commands in bin/. I'm pretty sure you'll need to alter some of the ones I have to be more consistent when you alter the commands. If you check out CVS, the man pages are all in doc/man, and it should be fairly obvious how they're formatted. I'm not a big expert on writing man pages, so if you get into it and find a better way to format them, don't feel you have to stick with my work.
My eventual plan for the man pages is to convert these to HTML for the website as well as bundling them with a future release of 2.1. That way, I only have to update the man pages and regenerate the HTML rather than handling them separately. (Although if you want to start writing the site admin manual, which would include descriptions of these commands...)
If this is too much work, do feel free to do whatever you're able to do and I'll try to make things match. :)
And thank you *so* much for offering. You're right and it really should be done, and I think it's one of those little things that can make those scripts more pleasant to use.
Terri
participants (4)
-
Brad Knowles
-
Russ Pagenkopf
-
Terri Oda
-
Tokio Kikuchi