Re: name for list of notes fields

2012-08-25 Thread Roland Winkler
On Tue Aug 21 2012 Roland Winkler wrote:
 On Tue Aug 21 2012 Leo wrote:
  bbdb-record-x tells me it is about extensions. Additionally, fields
  contained in x become meaningful, such as bbdb-record-x-uid,
  bbdb-record-set-x-uid etc. That is clarify that can not be attained
  otherwise. Just some random thoughts.
 
 The way BBDB works it does not have functions for individual fields
 such as bbdb-record-set-x-uid, and it does not need them.

Kind of natural would be `xfield' instead of `x' as a name for the
*list* of extra (custom) fields of a record. Certainly this matches
the lingo that both Leo and I used above.

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields

2012-08-25 Thread Leo
On 2012-08-26 04:09 +0800, Roland Winkler wrote:
 Kind of natural would be `xfield' instead of `x' as a name for the
 *list* of extra (custom) fields of a record. Certainly this matches
 the lingo that both Leo and I used above.

I am fine with this ;)

Leo


--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields

2012-08-20 Thread Roland Winkler
On Sun Aug 19 2012 Leo wrote:
 On 2012-08-19 00:36 +0800, Roland Winkler wrote:
  I guess `x' is really just a prefix -- for what? I'd prefer a more
  mnemonic name here.
 
 Fair enough though using 'x' to mean extension is not uncommon. For
 example, in emacs, we have a few libs: files-x, dired-x etc.

I know where the prefix x comes from in this context. Still I do not
see how the code of BBDB becomes more clear if BBDB internals such
as bbdb-record-Notes are renamed to bbdb-record-x. There are good
reasons why Emacs commonly does not use names like foo-bar-x.

In any case, 99% percent of all BBDB users should not notice such a
change even if they write their own functions or commands to
customize BBDB.

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields

2012-08-18 Thread Roland Winkler
On Fri Aug 17 2012 Leo wrote:
 Would you be OK with 'x'? I got the idea from vcard where custom
 fields are prefixed with x-.

I guess `x' is really just a prefix -- for what? I'd prefer a more
mnemonic name here.

Roland

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields

2012-08-18 Thread Mark Diekhans
Roland Winkler wink...@gnu.org writes:
 I guess `x' is really just a prefix -- for what? I'd prefer a more
 mnemonic name here.

The X- prefix is a convention sometimes used to indicate it's an
application-specific `eXtension' to some standard.  This is
common in mail headers, for instance your mail contains the
headers:

   X-Mozilla-Status: 0001
   X-Mozilla-Status2: 

This isn't not arguing for or against using it, just pointing
out the origin.

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields

2012-08-18 Thread Leo
On 2012-08-19 00:36 +0800, Roland Winkler wrote:
 I guess `x' is really just a prefix -- for what? I'd prefer a more
 mnemonic name here.

Fair enough though using 'x' to mean extension is not uncommon. For
example, in emacs, we have a few libs: files-x, dired-x etc.

Leo


--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields

2012-08-15 Thread Roland Winkler
On Tue Aug 14 2012 Ivan Kanis wrote:
 I have the following patch floating about. Would it affect me?

This is safe.

 +(defun bbdb-record-edit-notes ()
 +  Edit notes of current record.
 +  (interactive)
 +  (bbdb-edit-field (bbdb-current-record) 'notes))

High-level functions such as bbdb-edit-field and
bbdb-record-set-field are intended as an intermediate layer to the
nitty-gritty internals of BBDB.

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields (was Re: Add some BBDB tests)

2012-08-14 Thread Leo
On 2012-08-14 05:34 +0800, Roland Winkler wrote:
 However, Leo's proposed change could also affect function names such
 as bbdb-record-note and bbdb-record-set-note that address individual
 note fields. To be internally consistent, these should become
 something like bbdb-record-ext and bbdb-record-set-ext. I am a bit
 hesitant to make such a change.

Thanks Roland for the explanation.

Come to think about it again, 'ext' is not a good name. I wonder if
there is one that doesn't look like note/notes/Notes? ;)

Leo


--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields

2012-08-14 Thread Roland Winkler
On Tue Aug 14 2012 Leo wrote:
 On 2012-08-14 05:34 +0800, Roland Winkler wrote:
  However, Leo's proposed change could also affect function names such
  as bbdb-record-note and bbdb-record-set-note that address individual
  note fields. To be internally consistent, these should become
  something like bbdb-record-ext and bbdb-record-set-ext. I am a bit
  hesitant to make such a change.
 
 Thanks Roland for the explanation.
 
 Come to think about it again, 'ext' is not a good name. I wonder if
 there is one that doesn't look like note/notes/Notes? ;)

I thought about this for a little while because the name clash in
the BBDB internals really annoyed me. In the end, the defstruct
change from notes to Notes was the best that came to my mind.
But as I said before: better suggestions welcome!

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields (was Re: Add some BBDB tests)

2012-08-13 Thread Ivan Kanis
Roland Winkler wink...@gnu.org wrote:

 On Sun Aug 12 2012 Leo wrote:
 (bbdb-defstruct record
   firstname lastname affix aka organization phone address mail notes cache)
 
 We should rename `notes' in the above to `ext' (for extensions). `notes'
 and `note' are both used in the BBDB and they confuse me every time.


 Votes are welcome!

My vote is to keep notes. I have used BBDB for years and have never seen
note (without an s at the end). Furthermore ext makes me think of phone
of extension which I think this field is not about.
-- 
Ivan Kanis
http://ivan.kanis.fr

The web, then, or the pattern; a web at once sensuous and logical, an
elegant and pregnant texture: that is style, that is the foundation of
the art of literature.
-- Robert Louis Stevenson

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: name for list of notes fields (was Re: Add some BBDB tests)

2012-08-13 Thread Roland Winkler
On Mon Aug 13 2012 Ivan Kanis wrote:
 Roland Winkler wink...@gnu.org wrote:
  On Sun Aug 12 2012 Leo wrote:
  (bbdb-defstruct record
firstname lastname affix aka organization phone address mail notes cache)
  
  We should rename `notes' in the above to `ext' (for extensions). `notes'
  and `note' are both used in the BBDB and they confuse me every time.
 
 My vote is to keep notes. I have used BBDB for years and have never seen
 note (without an s at the end). Furthermore ext makes me think of phone
 of extension which I think this field is not about.

Leo's proposal only affects BBDB internals. As I said in my previous
email, the proposed change should not be noticeable for most users.
The question is about the generic internal name for user-defined
note fields. A note field is a cons (LABEL . VALUE), where LABEL is
the name of the note field chosen by the user (and visible to the
user), and VALUE is its value (a string). The most common value for
LABEL is `notes'. Previously the internal name for the list of all
such cons pairs was also `notes' which was very confusing, as noted
by Leo. I replaced this internal name by `Notes'. Leo didn't know I
recently made this change. He suggested `ext' instead.

However, Leo's proposed change could also affect function names such
as bbdb-record-note and bbdb-record-set-note that address individual
note fields. To be internally consistent, these should become
something like bbdb-record-ext and bbdb-record-set-ext. I am a bit
hesitant to make such a change.

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/