Re: Manual for BBDB 3

2011-11-21 Thread Christian Egli
Roland Winkler wink...@gnu.org writes:

 On Sun Nov 20 2011 Philipp Moeller wrote:
 So for now it is just looking at source and figuring things out.

 I am sorry, the updates in BBDB v3 are still work in progress.
 The code itself is already fairly mature by now, but the rest
 (documentation and installation support) is stil lacking behind.

 Volunteers welcome  :-)

Where would I find the source of the manual, i.e. the texinfo file? The
git repo doesn't seem to contain the manual. The best I was able to find
was at sourceforge
(http://bbdb.cvs.sourceforge.net/viewvc/bbdb/bbdb/texinfo/bbdb.texinfo?revision=1.59)
although I'm not sure how up-to-date this is. 

Thanks
Christian

-- 
Christian Egli
Swiss Library for the Blind, Visually Impaired and Print Disabled
Grubenstrasse 12, CH-8045 Zürich, Switzerland


--
All the data continuously generated in your IT infrastructure 
contains a definitive record of customers, application performance, 
security threats, fraudulent activity, and more. Splunk takes this 
data and makes sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-novd2d
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/

Re: Manual for BBDB 3

2011-11-21 Thread Barak A. Pearlmutter
 ... The goal is to make BBDB part of GNU Emacs, which requires that
 the copyright for all its code (from all contributors) gets assigned
 to the FSF.

I sent in the needed paperwork, and would encourage others to do so as
well.  It is reasonably painless, and you get a free sticker, although
I certainly concede that stickers are probably better at motivating
toddlers than computer programmers.

--Barak.
--
Barak A. Pearlmutter
 Hamilton Institute  Dept Comp Sci, NUI Maynooth, Co. Kildare, Ireland
 http://www.bcl.hamilton.ie/~barak/

--
All the data continuously generated in your IT infrastructure 
contains a definitive record of customers, application performance, 
security threats, fraudulent activity, and more. Splunk takes this 
data and makes sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-novd2d
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: Manual for BBDB 3

2011-11-20 Thread Carson Chittom
Philipp Möller bootsare...@googlemail.com writes:

 I'm new to BBDB and confused by which manual to use for which version.
 I currently use BBDB version 3.02 ($Date: 2011/10/10 18:04:34 $) and it
 seems there is no info manual included and the only manual I could find
 is at: http://bbdb.sourceforge.net/bbdb.html and I can't make out which
 parts of the manual are still up to date.

From interactions on this list, it appears that most-to-all of the old
manual is invalid for BBDB3.

 Is there an explicit manual for BBDB3 or is the old one still
 approriate?

As far as I'm aware there is no manual for BBDD3.  I'll be glad to help
proofread if you want to write one.  :)


-- 
http://www.wistly.net

--
All the data continuously generated in your IT infrastructure 
contains a definitive record of customers, application performance, 
security threats, fraudulent activity, and more. Splunk takes this 
data and makes sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-novd2d
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/

Re: Manual for BBDB 3

2011-11-20 Thread Philipp Moeller
Carson Chittom car...@wistly.net writes:

 Philipp Möller bootsare...@googlemail.com writes:

 I'm new to BBDB and confused by which manual to use for which version.
 I currently use BBDB version 3.02 ($Date: 2011/10/10 18:04:34 $) and it
 seems there is no info manual included and the only manual I could find
 is at: http://bbdb.sourceforge.net/bbdb.html and I can't make out which
 parts of the manual are still up to date.

 From interactions on this list, it appears that most-to-all of the old
 manual is invalid for BBDB3.

So for now it is just looking at source and figuring things out.


 Is there an explicit manual for BBDB3 or is the old one still
 approriate?

 As far as I'm aware there is no manual for BBDD3.  I'll be glad to help
 proofread if you want to write one.  :)

If someone could provide an outline of main features it would be a good start.

Is https://github.com/barak/bbdb3 the right place to fork and send pull
requests?

Philipp

--
All the data continuously generated in your IT infrastructure 
contains a definitive record of customers, application performance, 
security threats, fraudulent activity, and more. Splunk takes this 
data and makes sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-novd2d
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/

Re: Manual for BBDB 3

2011-11-20 Thread Johnny
Philipp Moeller bootsare...@googlemail.com writes:

 Carson Chittom car...@wistly.net writes:

 Philipp Möller bootsare...@googlemail.com writes:

 I'm new to BBDB and confused by which manual to use for which version.

 From interactions on this list, it appears that most-to-all of the old
 manual is invalid for BBDB3.

 So for now it is just looking at source and figuring things out.


Please don't disregard the old manual completely, but read with caution!

I have learned to use BBDB 3 pretty much from the old manual, so it's
certainly a reasonable place to start. There are some breaking changes
in variable names, and that's where looking at the docstrings / source
or eventually the mailing list comes in.

If you have the time, keep notes of the changes as you learn; these will
be useful for updating the manual. I asked about this previously, but it
seems an update is (understandably) not on top of the todo list. 

I guess if the info files are included in git, maybe someone else than
the main developer(s?) could work on it? I wouldn't mind trying to help,
but have limited experience.

The only note (unfortunately) I have kept is below.

,
| ;(add-hook 'message-setup-hook 'bbdb-define-all-aliases)   ; BBDB 2.35
| (add-hook 'message-setup-hook 'bbdb-mail-aliases) ; BBDB 3.x
`

Also, I think the set-up has changed; see a recent message on the list
on this.

-- 
Johnny

--
All the data continuously generated in your IT infrastructure 
contains a definitive record of customers, application performance, 
security threats, fraudulent activity, and more. Splunk takes this 
data and makes sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-novd2d
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/

Re: Manual for BBDB 3

2011-11-20 Thread Roland Winkler
On Sun Nov 20 2011 Philipp Moeller wrote:
 So for now it is just looking at source and figuring things out.

I am sorry, the updates in BBDB v3 are still work in progress.
The code itself is already fairly mature by now, but the rest
(documentation and installation support) is stil lacking behind.

Volunteers welcome  :-)

For someone new to BBDB, the most important piece of source code to
look into is certainly the beginning of bbdb.el with all the user
variables for BBDB. I tried to arrange them in a logical order.

Also, the menu bar gives you a fairly complete overview of the
commands available inside the *BBDB* buffer. (For many emacs modes
the menu bar comes handy for this.)

 If someone could provide an outline of main features it would be a
 good start.

For getting an idea of what can be done with BBDB, the old info
manual could still be usueful, though the implementation of these
ideas has changed quite significantly.

 Is https://github.com/barak/bbdb3 the right place to fork and send pull
 requests?

I do not know to what extent Barak keeps his mirror up to date.

BBDB is available at
http://savannah.nongnu.org/projects/bbdb/
To check it out, use
git clone git://git.savannah.nongnu.org/bbdb.git


Roland

--
All the data continuously generated in your IT infrastructure 
contains a definitive record of customers, application performance, 
security threats, fraudulent activity, and more. Splunk takes this 
data and makes sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-novd2d
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/