pan-users
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Pan-users] Re: Documentations


From: Duncan
Subject: [Pan-users] Re: Documentations
Date: Thu, 14 May 2009 16:03:05 +0000 (UTC)
User-agent: Pan/0.133 (House of Butterflies)

"Glen Stark" <address@hidden> posted
address@hidden, excerpted below, on  Thu, 14 May 2009
15:04:27 +0200:

> Hi Everyone.
> 
> Well, I've been silently observing the mailing list for a while now. 
> I'm happy to see that it's still pretty active.  Just to let everyone
> know where I'm coming from, I'm actually a pretty good programmer,
> particularly in C++. I'm a bit of a GTK neophyte, but I have written a
> couple of small applications using the toolkit, so I can usually muddle
> my way around.

Cool. =:^)

> I recently checked out the cvs version of pan, because I wanted to be
> able to download multiple articles using only the keyboard. 
> Unfortunately this is proving to be a little trickier than I would have
> thought, and I just don't have the time right now to work on it.   But I
> hope soon.

CVS was just a figure of speech, right?  You mean Subversion or GIT, 
right?  (FWIW Gnome just announced a switch to GIT not long ago, and 
PAN's repository is with Gnome, but I don't know the status of pan's 
switch, directly.  But before that it was subversion.)

On the keyboard-only bit, I'm honestly not sure.  I certainly must have 
my keyboard shortcuts, but I'm personally mixed-mode and switch between 
keyboard and mouse easily and often enough that I honestly can't say how 
pan does on keyboard shortcuts.

You have discovered that all the menu actions have customizable hotkey 
assignments, right?  No coding necessary for that, just editing the 
accels.txt file, in pan's standard data dir, ~/.pan2 by default, and mine 
is certainly heavily customized so I know it works.  (It can sort of be 
done from the GUI, under certain circumstances and with some limitations, 
but editing the accels.txt file works better for me.  Keep in mind that 
pan re-dumps it at every close, scrambling the order, so if you sort it, 
sort it to another file, and copy it over the accels.txt any time you 
make changes.)

But... I'm still not sure how easy all keyboard navigation is.  Hotkeys 
are one thing, but general navigation is something else entirely, and I 
normally use the mouse for that so don't know how good pan is or isn't.

> On the other hand, I had a few ideas that I thought we on the list might
> get active on, kind of as a present for Charles, if and when he graces
> us with his presence again.  The first was documentation.

Good idea.  I know during the long break that ended when Charles revealed 
the C++ rewrite, several folks got involved somewhat, and Charles was 
able to use their ideas to VASTLY improve memory handling and scaling in 
the rewrite.

> I read the recent discussion regarding the decision to simplify the UI,
> and how we have to muck around in the preferences file.  I actually find
> this a good philosophy, although I would debate on a point by point
> basis on certain GUI elements that have been excluded.  Anyway, this got
> me to thinking that the problem with not having a GUI to set, for
> example, the default cache size, is it's not immediately transparent to
> figure out how to do such a thing.  That further got me to thinking
> that, jesus, that web page saying the pan project is going to have
> documentation soon hasn't changed in YEARS!

Yeah.  People keep starting on it, then they run out of steam and it 
doesn't go much of anywhere.  Charles has said that the object in the GUI 
is to make it so it needs no documentation, and Pan does reasonably well 
with that I think, at least for those who've worked with other news 
clients, but that doesn't take care of the stuff that's not in the GUI.

> Now I recently set up a couple of wikis at work, and y'know, it's easy
> and quick.  I'm totally willing to set up a pan wiki for people to write
> documentation, if anyone out there wants to contribute to it.  So if 2
> or more people say "heck yeah, I'd write a page or two", I'll set you up
> a wiki, and provide the hosting. I'll even donate a few hours here or
> there writing a little docu myself, but I'm not going to do the whole
> thing myself.  I'll put it right out in front that if Charles wants to
> take it over and incorporate it over at rebelbase, it's his.

Actually, someone had put together a wiki.  I'm honestly not sure how 
much he got on it.

FWIW, I'm told I'm reasonably good at explaining things (while OTOH being 
told I'm too wordy and repeat things, but luckily that works for some 
people, as it seems to be the way I am), but that's on the list/newsgroup 
(newsgroup, aka list, but thru gmane's list2news gateway).  In pretty 
much any other medium, including wikis/blogs/web- forums, I don't do so 
well and get writer's block.  So while I certainly don't mind people 
taking my list/news posts for their wikis, that's what it ends up being 
and I don't contribute much directly, only thru the group/list.

So anyway, I'm not sure I even visited the previous wiki, and I'm not 
sure how well it did or even if it's still up.  If that guy is still 
around on the list, perhaps you two can collaborate.  I wonder if I can 
still find the link and check it...

> As for code contributions, I have a lot on my plate at the moment, but I
> might be able to squeeze a little time into working on PAN in July.  I
> could probably make my patches available.  If any of you non coders have
> quick and easy things that are driving you nuts, maybe I could hook you
> up, as a way of getting my feet wet in the PAN pool.

I'm not sure how "quick and easy" these are, but here's the common list.

My pet wish:

Extend the scoring so it works on all headers and the body, once they are 
available.  Working on overview headers only is nice for pre-download 
actions, but it's very limiting, and if a second scoring run could be 
done once the post was local, it would enable, for example, killfiling 
those trolls that change from headers constantly, to avoid killfiles, but 
have a unique non-overview header, say nntp-posting-host, or post content 
heavily infused with ALL CAPS or swearing, for instance.  This has been 
on my wishlist for /years/ since before scoring when it was still three-
way-filtering (kill/normal/watch).

Charles "blueskied" it.  Nice to have, but not likely right away, unless 
someone supplies the patch... and I don't code.  Unfortunately, this 
probably isn't "quick and easy".

Frequent request:

This one may be easier... maybe.  Make the group list tree nestable, with 
the ability to sort groups into user labeled categories.  This was sort 
of doable with old-pan, by setting up different logical servers (which 
could point to the same server address), since each server was handled 
separately.  New-pan integrates the groups from all servers into the same 
list, so that no longer works.  Personally, I use the PAN_HOME env 
variable feature to setup multiple pan instances and sort my groups that 
way, but that's rather more complex and inconvenient than a nestable tree 
setup would be.

Frequent request:

Setup scoring actions, with a new preferences tab that allows one to 
automatically delete, mark-read, cache, or download and save, based on 
scoring categories (the same scoring categories pan already uses).  The 
preferences tab layout has been discussed, ask if you're thinking about 
doing it.  The meat of the patch, however, would be the engine to 
automate the actions based on the score.

This one's a fairly high priority for Charles too, as it's the last real 
feature that old-pan had that new-pan doesn't.  Given that pan can 
already auto-fetch headers/overviews, this would allow users that wished 
to, to pretty much entirely automate pan, making it cron-job-schedulable 
or the like so they could set it up to fetch messages a couple hours 
before they come home from work, say, and have them all downloaded and 
waiting.  (The mechanism would be to simply set auto-download for normal-
scored or better, but we need the feature available, first.)

Partially implemented patches:

There are already patches for a couple other neat features, including the 
ability to set preferred spell-check language per-group. for instance.  
As-is the patch doesn't really match Charles' simplicity standards as one 
must type in the appropriate language abbreviations (it'd be better if 
they were drop-down selectable), but for those multi-linguals who 
participate in groups of different languages, its a seriously useful 
feature, none-the-less.  If you could figure out how to detect what's 
available and make the dropdown, this would almost certainly be taken on 
as a distribution level patch, even if Charles didn't implement it.  It'd 
be simply too useful to ignore.  I'm only English here so can't really 
test it, but I'm applying it and have the textbox for spelling language 
in my group preferences dialog.  Ask if interested and I'll dig up the 
patch and hopefully the bug and/or the list poster for it.

That one might be the easiest, and it WOULD be useful to a lot of people, 
tho not me so much.  Again, ask if interested and I'll post what I can 
get (at least the current patch, as I apply it) on it.

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman





reply via email to

[Prev in Thread] Current Thread [Next in Thread]