[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Guix Documentation Meetup
From: |
adriano |
Subject: |
Re: Guix Documentation Meetup |
Date: |
Thu, 30 Dec 2021 22:52:39 +0100 |
Il giorno dom, 12/12/2021 alle 21.50 -0600, Katherine Cox-Buday ha
scritto:
> - In geiser, run =,a thing-i-want-to-look-for= (this is supposedly an
> apropos
> command that is supposed to search symbols for you). The command
> returns
> nothing. I realize I have to import the module implementing the
> thing I'm
> looking for first, thus defeating the purpose.
about this, I want to report an example
scheme@(guile-user)> (help tail)
Did not find any object named `tail'
scheme@(guile-user)>
BUT
scheme@(guile-user)> (help "tail") <-- notice the quotation marks !
Documentation found for:
(language cps): $ktail
(language tree-il): seq-tail
(language tree-il): abort-tail
(guile): list-tail
(guile): make-struct/no-tail
(srfi srfi-1): find-tail
(system vm assembler): emit-tail-call-label
(system vm assembler): emit-tail-call
(system vm assembler): emit-tail-pointer-ref/immediate
(ice-9 vlist): vlist-tail
`$ktail' is an object in the (language cps) module.
- Variable: $ktail
`seq-tail' is a procedure in the (language tree-il) module.
- Variable: seq-tail
`abort-tail' is a procedure in the (language tree-il) module.
- Variable: abort-tail
`list-tail' is a procedure in the (guile) module.
- Function: list-tail _ _
- Scheme Procedure: list-tail lst k
Return the "tail" of LST beginning with its Kth element. The
first
element of the list is considered to be element 0.
`list-tail' and `list-cdr-ref' are identical. It may help to
think
of `list-cdr-ref' as accessing the Kth cdr of the list, or
returning the results of cdring K times down LST.
`make-struct/no-tail' is a procedure in the (guile) module.
- Function: make-struct/no-tail _ . _
- Scheme Procedure: make-struct/no-tail vtable . init
Create a new structure.
VTABLE must be a vtable structure (see Vtables).
The INIT1, ... are optional arguments describing how
successive
fields of the structure should be initialized. Note that
hidden
fields (those with protection 'h') have to be manually set.
If fewer optional arguments than initializable fields are
supplied,
fields of type 'p' get default value #f while fields of type
'u'
are initialized to 0.
`find-tail' is a procedure in the (srfi srfi-1) module.
- Function: find-tail pred lst
Return the first pair of LST whose CAR satisfies the predicate
PRED, or return `#f' if no such element is found.
`emit-tail-call-label' is a procedure in the (system vm assembler)
module.
- Function: emit-tail-call-label asm t-ff72ee5a3696d21-378b
`emit-tail-call' is a procedure in the (system vm assembler) module.
- Function: emit-tail-call asm
`emit-tail-pointer-ref/immediate' is a procedure in the (system vm
assembler) module.
- Function: emit-tail-pointer-ref/immediate asm t-ff72ee5a3696d21-3ac6
t-ff72ee5a3696d21-3ac7 t-ff72ee5a3696d21-3ac8
`vlist-tail' is a procedure in the (ice-9 vlist) module.
- Function: vlist-tail vlist
Return the tail of VLIST.
That is, help with the quotation marks reports about things even if
they're in namespaces you haven't imported yet !
I'm confused about the difference between help withouth and with the
quotation marks
In fact
scheme@(guile-user)> ,a tail
(guile): list-tail #<procedure list-tail (_ _)>
(guile): make-struct/no-tail #<procedure make-struct/no-tail (_ .
_)>
apropos does find at least something, but
scheme@(guile-user)> (help tail)
Did not find any object named `tail'
help with no quotation marks finds nothing !
Why is this so ?
I can't fathom that ¯\_(ツ)_/¯
And I can't even remember how I discovered this behaviour
I remember I was quite puzzled when I did
This is hidden and arbitrary
But it IS like that !
So maybe this little trick can make your sessions a bit less
frustrating !
"tail" was just a silly example I was able to come up with
I'd be curious to try with some of your things :-)
Bye
Adriano
Re: Guix Documentation Meetup, zimoun, 2021/12/13
Guile documentation, Ludovic Courtès, 2021/12/20
Re: Guix Documentation Meetup, adriano, 2021/12/21
Re: Guix Documentation Meetup, Blake Shaw, 2021/12/10
Re: Guix Documentation Meetup, Blake Shaw, 2021/12/13