bug#18190: 24.4.50; doc string of `auth-source-backend-child-p'

bug#18190: 24.4.50; doc string of `auth-source-backend-child-p'

[Drew Adams]

Incomprehensible (gibberish).  Probably a typo or two in that sentence
somewhere.

In GNU Emacs 24.4.50.1 (i686-pc-mingw32)
 of 2014-06-28 on ODIEONE
Bzr revision: 117431 rgm@gnu.org-20140628015517-eku6hj8mpgcvfnso
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/snapshot/trunk
 --enable-checking=yes,glyphs 'CFLAGS=-O0 -g3'
 LDFLAGS=-Lc:/Devel/emacs/lib 'CPPFLAGS=-DGC_MCHECK=1
 -Ic:/Devel/emacs/include''

bug#18190: 24.4.50; doc string of `auth-source-backend-child-p'

[Lars Ingebrigtsen]

Drew Adams <drew.adams@oracle.com> writes:

> Incomprehensible (gibberish).  Probably a typo or two in that sentence
> somewhere.

Looks fine now, at least:

auth-source-backend-child-p is an alias for
‘auth-source-backend--eieio-childp’.

(auth-source-backend-child-p OBJ)

This function is obsolete since 25.1;
use (cl-typep ... \='auth-source-backend) instead

Return non-nil if OBJ is an object of type ‘auth-source-backend’ or a subclass.


-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#18190: 24.4.50; doc string of `auth-source-backend-child-p'

[Drew Adams]

> > Incomprehensible (gibberish).  Probably a typo or two in that sentence
> > somewhere.
> 
> Looks fine now, at least:
> 
> auth-source-backend-child-p is an alias for
> 'auth-source-backend--eieio-childp'.
> 
> (auth-source-backend-child-p OBJ)
> 
> This function is obsolete since 25.1;
> use (cl-typep ... \='auth-source-backend) instead
> 
> Return non-nil if OBJ is an object of type 'auth-source-backend' or a
> subclass.

That's certainly a lot better than what it was when I reported
the bug:

 Test OBJ to see if it an object is a child of type auth-source-backend

But if you try to understand what it says now, `C-h f cl-typep'
tells you only:

  This function has a compiler macro 'cl-typep--inliner'.

  Not documented.

One problem at a time, I guess...

Is there perhaps a typo in this part?

  (cl-typep ... \='auth-source-backend)

What does the ... correspond to?  And what's with \='?

bug#18190: 24.4.50; doc string of `auth-source-backend-child-p'

[Lars Ingebrigtsen]

Drew Adams <drew.adams@oracle.com> writes:

> One problem at a time, I guess...
>
> Is there perhaps a typo in this part?
>
>   (cl-typep ... \='auth-source-backend)
>
> What does the ... correspond to?  And what's with \='?

Yes, very odd.  

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#18190: 24.4.50; doc string of `auth-source-backend-child-p'

[Andreas Schwab]

Lars Ingebrigtsen <larsi@gnus.org> writes:

> Drew Adams <drew.adams@oracle.com> writes:
>
>> One problem at a time, I guess...
>>
>> Is there perhaps a typo in this part?
>>
>>   (cl-typep ... \='auth-source-backend)
>>
>> What does the ... correspond to?  And what's with \='?
>
> Yes, very odd.  

Fixed.

Andreas.

-- 
Andreas Schwab, schwab@linux-m68k.org
GPG Key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."