Re: [Raku/old-design-docs] 1c4e60: Remove Larry's email address.

2025-06-08 Thread Hal Wigoda
ling >> or grammatical errors.) >> >>>> On Jun 8, 2025, at 7:18 AM, Will Coleda via perl6-language >>>> wrote: >>> >>>  Branch: refs/heads/master >>> Home: https://github.com/Raku/old-design-docs >>> Commit: 1c4e6039a11

Re: [Raku/old-design-docs] 1c4e60: Remove Larry's email address.

2025-06-08 Thread Elizabeth Mattijsen
any spelling > or grammatical errors.) > >> On Jun 8, 2025, at 7:18 AM, Will Coleda via perl6-language >> wrote: >> >>  Branch: refs/heads/master >> Home: https://github.com/Raku/old-design-docs >> Commit: 1c4e6039a116421c7db

Re: [Raku/old-design-docs] 1c4e60: Remove Larry's email address.

2025-06-08 Thread Hal Wigoda
ub.com/Raku/old-design-docs > Commit: 1c4e6039a116421c7dbd36c56c34d3f774dcaf8f > > https://github.com/Raku/old-design-docs/commit/1c4e6039a116421c7dbd36c56c34d3f774dcaf8f > Author: Will Coleda > Date: 2025-06-08 (Sun, 08 Jun 2025) > > Changed paths: >M S01-over

[Raku/old-design-docs] 1c4e60: Remove Larry's email address.

2025-06-08 Thread Will Coleda via perl6-language
Branch: refs/heads/master Home: https://github.com/Raku/old-design-docs Commit: 1c4e6039a116421c7dbd36c56c34d3f774dcaf8f https://github.com/Raku/old-design-docs/commit/1c4e6039a116421c7dbd36c56c34d3f774dcaf8f Author: Will Coleda Date: 2025-06-08 (Sun, 08 Jun 2025) Changed

[Raku/old-design-docs] 07ac3b: rm broken link

2024-01-18 Thread librasteve via perl6-language
Branch: refs/heads/master Home: https://github.com/Raku/old-design-docs Commit: 07ac3bb2ab509a5143e5f99a0e9c32b823828fae https://github.com/Raku/old-design-docs/commit/07ac3bb2ab509a5143e5f99a0e9c32b823828fae Author: librasteve <40125330+librast...@users.noreply.github.com>

raku/docs: Planning

2022-05-08 Thread Will Coleda
Mentioning on list since I know this has specifically come up in the past. If you are working on something for the documentation site, please let me know. I am trying to get a list of all the projects in flight right now. Please see https://github.com/Raku/doc/wiki for what's on my list right now

Re: Docs on docs.raku.org need automated build

2021-11-15 Thread Tom Browder
On Mon, Nov 15, 2021 at 12:43 JJ Merelo wrote: > Done also for the official site, https://docs.raku.org > Check it out. > Thank you, JJ--it looks great! -Tom

Re: Docs on docs.raku.org need automated build

2021-11-15 Thread JJ Merelo
Done also for the official site, https://docs.raku.org Check it out. El lun, 15 nov 2021 a las 19:17, JJ Merelo () escribió: > Testing the newly deployed docs here https://rakudocs.github.io/ > > I'll try and do a couple of updates and checks and if everything is OK, > w

Re: Docs on docs.raku.org need automated build

2021-11-15 Thread JJ Merelo
Testing the newly deployed docs here https://rakudocs.github.io/ I'll try and do a couple of updates and checks and if everything is OK, will deploy to the official site. El dom, 14 nov 2021 a las 19:54, Tom Browder () escribió: > Doc site i see is several weeks old and missing my las

Docs on docs.raku.org need automated build

2021-11-14 Thread Tom Browder
Doc site i see is several weeks old and missing my last merged contrib on example of programmatic use of ‘require’. Any hope of a rebuild this month? -Tom

[Raku/old-design-docs] 63e44c: S22: Clarify how system specific values work and c...

2020-10-01 Thread niner via perl6-language
Branch: refs/heads/master Home: https://github.com/Raku/old-design-docs Commit: 63e44c36351887f1eb76500d7102f0db44848d27 https://github.com/Raku/old-design-docs/commit/63e44c36351887f1eb76500d7102f0db44848d27 Author: niner Date: 2020-10-01 (Thu, 01 Oct 2020) Changed paths

[Raku/old-design-docs] b13e78: Update dependency specifications in S22

2020-09-30 Thread niner via perl6-language
Branch: refs/heads/master Home: https://github.com/Raku/old-design-docs Commit: b13e78fe5b9dc10bfdacb0122ea40a77b6037ac9 https://github.com/Raku/old-design-docs/commit/b13e78fe5b9dc10bfdacb0122ea40a77b6037ac9 Author: Stefan Seifert Date: 2020-09-30 (Wed, 30 Sep 2020

[Raku/old-design-docs]

2020-04-26 Thread ven
Branch: refs/heads/zag-patch-1 Home: https://github.com/Raku/old-design-docs

[Raku/old-design-docs] 1a90f9: fix identifier in used context

2020-04-26 Thread Tom Browder
Branch: refs/heads/master Home: https://github.com/Raku/old-design-docs Commit: 1a90f942619e0d027f9c19228003e20a1997364d https://github.com/Raku/old-design-docs/commit/1a90f942619e0d027f9c19228003e20a1997364d Author: Aliaksandr Zahatski Date: 2020-04-26 (Sun, 26 Apr 2020

[Raku/old-design-docs] 1a90f9: fix identifier in used context

2020-04-26 Thread Aliaksandr Zahatski
Branch: refs/heads/zag-patch-1 Home: https://github.com/Raku/old-design-docs Commit: 1a90f942619e0d027f9c19228003e20a1997364d https://github.com/Raku/old-design-docs/commit/1a90f942619e0d027f9c19228003e20a1997364d Author: Aliaksandr Zahatski Date: 2020-04-26 (Sun, 26 Apr 2020

[Raku/old-design-docs]

2020-02-05 Thread Elizabeth Mattijsen
Branch: refs/heads/design-into-raku Home: https://github.com/Raku/old-design-docs

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-11 Thread Todd Chester via perl6-users
On 2019-12-11 14:26, Joseph Brenner wrote: Joseph Brenner wrote: The signatures in the documentation are certainly helpful, but they're no substitute for code examples. I'd go after adding more code examples, rather than removing other stuff. But then, maybe I'm coming into this discussi

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-11 Thread Todd Chester via perl6-users
On 2019-12-11 14:06, Joseph Brenner wrote: The signatures in the documentation are certainly helpful, but they're no substitute for code examples. I'd go after adding more code examples, rather than removing other stuff. Hi Joseph, I would compromise on that. I would also like to see th

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-11 Thread Joseph Brenner
Joseph Brenner wrote: > The signatures in the documentation are certainly helpful, but they're > no substitute for code examples. I'd go after adding more code > examples, rather than removing other stuff. But then, maybe I'm coming into this discussion in the middle-- is the topic here adding

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-11 Thread Joseph Brenner
The signatures in the documentation are certainly helpful, but they're no substitute for code examples. I'd go after adding more code examples, rather than removing other stuff.

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-11 Thread Simon Proctor
I would argue that signatures are great for any command line script because you can use them with MAIN to get input checking. On Wed, 11 Dec 2019, 18:07 Veesh Goldman, wrote: > I believe there's a disparity here between the needs of a sysadmin and > people who program hardcore with Raku. That's

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-11 Thread Veesh Goldman
I believe there's a disparity here between the needs of a sysadmin and people who program hardcore with Raku. That's what I'm seeing in the discussion here. Signatures are very important to those who write programs, because they help you arrange your code in a clean and maintainable and predictabl

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-11 Thread yary
> The signatures are very important to the developers. > They only confuse the programmer. Speak for yourself, I'm not developing the innards of Raku, I'm just using it for projects- like you. And I NEED the signatures. They tell me so much!! -y On Mon, Dec 9, 2019 at 6:53 PM ToddAndMargo via p

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread ToddAndMargo via perl6-users
efinition, including signature, right there—signatures in the docs are not intended for them. If one is /using/ a routine in internals/core, or needs to refer to other versions of a multi, then that “developer” is acting as a “programmer” at that moment—they are using, not modifying, the routine in

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread Trey Harris
tion. And, in fact, I find it difficult to understand why you’d think most routine signatures would be *more* useful to “developers” vs. “programmers” in your formulation: if one is modifying a routine in core or in the compiler, one has the definition, including signature, right there—signatures in

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread Brian Duggan
Hi Folks, While the tone of this conversation is a little unpleasant I think there are good points about the readability of the reference documentation. For instance, I understand that List inherits from "Cool", but listing trigonometric functions on this page https://docs.raku.org/type/List

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread ToddAndMargo via perl6-users
On 2019-12-10 03:31, Veesh Goldman wrote: Nobody said not to do it. Please make more documentation available to the public. But that doesn't mean that these docs need to change. It's reference, not guides. And also it doesn't need to be a wiki. You could do everything on Git

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread ToddAndMargo via perl6-users
On 2019-12-10 03:02, ToddAndMargo via perl6-users wrote: I would "It would", not "I would" Stinkin' typos

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread Veesh Goldman
Nobody said not to do it. Please make more documentation available to the public. But that doesn't mean that these docs need to change. It's reference, not guides. And also it doesn't need to be a wiki. You could do everything on GitHub, where most people already do their collabor

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread ToddAndMargo via perl6-users
lled on a defined (D) String instance. The wording you use is a bit weird and it speak to my beliefe that you don't really get Signatures.     Do you see anywhere in the docs where how to read     signatures is explained?  (Don't get any ideas.  The     signatures should not be there to sta

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread ToddAndMargo via perl6-users
a bit weird and it speak to my beliefe that you don't really get Signatures. Do you see anywhere in the docs where how to read signatures is explained?  (Don't get any ideas.  The signatures should not be there to start with.) Apart from here? https://docs.raku.org/type/Sign

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread ToddAndMargo via perl6-users
people who have been writing that documentation for all those years really, really deserve to be thanked. A lot. -- Fernando Santagata Hi Fernando, You make good points. Please do not misinterpret my issues with they way the docs are presented as diminishing the work those people have put into it.

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread Simon Proctor
the signature > and explain each part. > > I did. It's pretty good except your understanding of the first part Str:D : This indicates that this method will be used when it's called on a defined (D) String instance. The wording you use is a bit weird and it speak to my beliefe

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-10 Thread Fernando Santagata
On Tue, Dec 10, 2019 at 3:53 AM ToddAndMargo via perl6-users < perl6-us...@perl.org> wrote: > On 2019-12-09 09:44, Trey Harris wrote: > > Signatures are important to Raku. > > Trey, > > The signatures are very important to the developers. > They only confuse the programmer. > > -T > I'm a program

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread ToddAndMargo via perl6-users
in various ways until you say you get it (and offer sample code to show that you do, indeed, seem to get it). 3. You complain the docs do not describe it in a way that you (or anyone—you frequently invoke yourself as the avatar of the “ordinary programmer” as opposed  to, for example, the

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread ToddAndMargo via perl6-users
that already know what they are doing? Why do you even post them for the general public? Have you seem Perl 5's perldoc? They are extremely well done. We need to follow their example. See any signatures in them? Perldocs is written for the user, not the developer. Raku's doc

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 09:44, Trey Harris wrote: Signatures are important to Raku. Trey, The signatures are very important to the developers. They only confuse the programmer. -T

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 07:35, Curt Tilmes wrote: Hmm... Project for someone bored -- We've already got a great Signature parser, how about creating a simplified human (HTML) description automagically from any Signature, then linking it from the actual Signature on each page... I second that request!

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread ToddAndMargo via perl6-users
. That is the code as it will be written in the Str Role. I *highly* advise learning how signatures work. Hi Simon, Did you see the How To post I made on ".contains"? At the bottom of the How To, I take apart the signature and explain each part. Do you see anywhere in the doc

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread ToddAndMargo via perl6-users
ack to Raku. Take a look at https://github.com/rakudo/rakudo/commit/696eea2de6e67135b3b574ecb579ede16045ede6 This is where the incorrect information presented on the Docs for .contains is being corrected (among other things). The commit is a fascinating insight into how the developers are doing

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread Philip Hazelden
(Apologies, forgot to reply all.) On Mon, Dec 9, 2019 at 1:47 AM ToddAndMargo via perl6-users < perl6-us...@perl.org> wrote: > Hi Phillip, > Have you ever been to an IEEE seminar and attended a lecture > on a subject that you have intimate knowledge on hoping > to pick up some additional tips. I

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread Trey Harris
ays in reaction to the same pattern of behavior: 1. You ask a question about something. 2. It is explained in various ways until you say you get it (and offer sample code to show that you do, indeed, seem to get it). 3. You complain the docs do not describe it in a way that you (or anyone—you freq

Re: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread Parrot Raiser
, JJ Merelo wrote: >> > Other than that, it's clear from the context that it returns a Boolean >> You still need to change the target audience of the docs >> from the Developers to the Rakoons. >> >> The reference documentation (especially deep inside) is NOT intend

Re: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread Mike Stok
ns a Boolean > You still need to change the target audience of the docs > from the Developers to the Rakoons. > > The reference documentation (especially deep inside) is NOT intended for > brand new people to the language. > > They need to start with the introduction, the tutorial

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread Curt Tilmes
On Mon, Dec 9, 2019 at 10:29 AM Simon Proctor wrote: > I think this does highlight something we probably should document more. > > How to read signatures. Because it's a *very* powerful part of the > language that if you don't understand you're only using it at half strength. > > multi method con

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread Curt Tilmes
On Mon, Dec 9, 2019 at 10:07 AM ToddAndMargo via perl6-users < perl6-us...@perl.org> wrote: > On 2019-12-09 02:00, JJ Merelo wrote: > > Other than that, it's clear from the context that it returns a Boolean > You still need to change the target audience of the docs >

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread Simon Proctor
contains(Str:D: Cool:D $needle, Cool:D $pos --> Bool:D) > > In the above, it is not real obvious to the Riff-Raff > (me), who is not have developer level ledge, that the > "Str:D" in inside the parenthesis, but instead feeding > the method. You have to get use to the c

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread ToddAndMargo via perl6-users
ou have to get use to the cryptography. You still need to change the target audience of the docs from the Developers to the Rakoons. -T

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-09 Thread JJ Merelo
to "call" a method, then the meaning is clear; and in fact, the way it > > was written seems like the obvious way to write it. > > > > If you don't know what those words mean, then the meaning won't be > > clear. (But even then, clicking the link on "St

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-08 Thread ToddAndMargo via perl6-users
t;Str.contains" and glancing down that page a little should give you some hints.) Perhaps, to make it easier for you to understand, the docs could stop using words like "invocant" and "coerce". But that makes it *harder* for people who do understand these words, because

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-07 Thread JJ Merelo
all. >> > >> > -- Forwarded message - >> > From: *Tom Browder* > tom.brow...@gmail.com>> >> > Date: Sat, Dec 7, 2019 at 04:58 >> > Subject: Raku, docs, help [was: Re: vulgar?] >> > To: ToddAndMargo mailto:toddandma...@zoho.

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-07 Thread Philip Hazelden
gt; >> > > Date: Sat, Dec 7, 2019 at 04:58 > > Subject: Raku, docs, help [was: Re: vulgar?] > > To: ToddAndMargo mailto:toddandma...@zoho.com>> > > > > > > On Fri, Dec 6, 2019 at 23:23 ToddAndMargo via perl6-users > > mailto:perl6-us...@perl.org&g

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-07 Thread ToddAndMargo via perl6-users
On 2019-12-07 03:59, ToddAndMargo via perl6-users wrote: On 2019-12-07 03:00, Tom Browder wrote: Forgot to reply to all. -- Forwarded message - From: *Tom Browder* <mailto:tom.brow...@gmail.com>> Date: Sat, Dec 7, 2019 at 04:58 Subject: Raku, docs, help [was: Re: vu

Re: Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-07 Thread ToddAndMargo via perl6-users
On 2019-12-07 03:00, Tom Browder wrote: Forgot to reply to all. -- Forwarded message - From: *Tom Browder* mailto:tom.brow...@gmail.com>> Date: Sat, Dec 7, 2019 at 04:58 Subject: Raku, docs, help [was: Re: vulgar?] To: ToddAndMargo mailto:toddandma...@zoho.com>> O

Fwd: Raku, docs, help [was: Re: vulgar?]

2019-12-07 Thread Tom Browder
Forgot to reply to all. -- Forwarded message - From: Tom Browder Date: Sat, Dec 7, 2019 at 04:58 Subject: Raku, docs, help [was: Re: vulgar?] To: ToddAndMargo On Fri, Dec 6, 2019 at 23:23 ToddAndMargo via perl6-users < perl6-us...@perl.org> wrote: > On 2019-12-06 1

Re: is inlinable trait missing from docs

2019-07-13 Thread JJ Merelo
ined and what wasn't, and IIRC the spesh > log can give you more specific info on why an inline was not performed in a > given case. > > HTH > - Timo > On 13/07/2019 12:51, Marcel Timmerman wrote: > > On 7/13/19 12:37 PM, Timo Paulssen wrote: > > I wouldn'

Re: is inlinable trait missing from docs

2019-07-13 Thread Marcel Timmerman
ine was not performed in a given case. HTH   - Timo On 13/07/2019 12:51, Marcel Timmerman wrote: On 7/13/19 12:37 PM, Timo Paulssen wrote: I wouldn't put "is inlinable" in the docs; it requires the user to put a QAST tree in the value, which isn't a thing an end-user would tou

Re: is inlinable trait missing from docs

2019-07-13 Thread Timo Paulssen
o On 13/07/2019 12:51, Marcel Timmerman wrote: > On 7/13/19 12:37 PM, Timo Paulssen wrote: >> I wouldn't put "is inlinable" in the docs; it requires the user to put a >> QAST tree in the value, which isn't a thing an end-user would touch, >> IMO. In fact I&#

Re: is inlinable trait missing from docs

2019-07-13 Thread Marcel Timmerman
On 7/13/19 12:37 PM, Timo Paulssen wrote: I wouldn't put "is inlinable" in the docs; it requires the user to put a QAST tree in the value, which isn't a thing an end-user would touch, IMO. In fact I'm not sure why we have a trait for that at all, since it's not us

Re: is inlinable trait missing from docs

2019-07-13 Thread Timo Paulssen
I wouldn't put "is inlinable" in the docs; it requires the user to put a QAST tree in the value, which isn't a thing an end-user would touch, IMO. In fact I'm not sure why we have a trait for that at all, since it's not used anywhere in rakudo's source. On 13/07

is inlinable trait missing from docs

2019-07-13 Thread Marcel Timmerman
Hi, I found out about a trait 'is inlinable' when I made a typo in using a trait on subs. There is no documentation for it so I thought maybe it is not implemented, experimental or some other reason it is kept out of the docs. Otherwise it should be documented too. Great w

Re: A comparison between P5 docs and p6 docs

2018-09-12 Thread Peter Scott
Ordinarily I would agree with you. But I know my own brain and how it works. I only learn by doing. Have tried to change that and can't. A good tutorial book *will* make you "do." The brian d foy book does exactly that with things to try, and questions to explore in your own code. It takes

Re: A comparison between P5 docs and p6 docs

2018-09-12 Thread Brad Gilbert
The signatures in the docs are often the exact same signatures as the code they are documenting. > Str.^lookup('contains').candidates.map: *.signature.say (Str:D: Cool:D $needle, *%_) (Str:D: Str:D $needle, *%_) (Str:D: Cool:D $needle, Cool:D $pos, *%_) (Str:D:

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread ToddAndMargo
minutes (at no cost) to download it and start enjoying it. Cheers, Laurent. Hi Laurent, Ordinarily I would agree with you. But I know my own brain and how it works. I only learn by doing. Have tried to change that and can't. When I "dive in", I open up the reference docs an

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread ToddAndMargo
t part. But the docs DO have examples, and any reader who sees the lack of a suitable one should file an issue or contribute a suitable change. I got my start here as a noob p6 user (coming from years of p5 use) contributing to the docs. And I, too, found many examples too obtuse for a noob, an

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread ToddAndMargo
On 09/11/2018 04:53 AM, Tom Browder wrote: Todd, some free advice: 1. DOCUMENTATION The docs are a volunteer effort. You can help by contributing changes and submitting issues. Hi Tom, I have started contributing to this effort as well. One of the big hurdles is that those maintaining the

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Tom Browder
On Tue, Sep 11, 2018 at 10:39 AM Parrot Raiser <1parr...@gmail.com> wrote: > > One of the paradoxes of documentation, and the teaching of many > abstract topics, is that those with the most in-depth knowledge of the ... I agree with you for the most part. But the docs DO have ex

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Parrot Raiser
One of the paradoxes of documentation, and the teaching of many abstract topics, is that those with the most in-depth knowledge of the topic,are the least suitable to explain it, precisely because of that knowledge. They can't remember what it felt like not to know something, and they've usually l

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Tom Browder
On Tue, Sep 11, 2018 at 10:31 AM Simon Proctor wrote: > > It's a very good read. :) Yes it is!

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Simon Proctor
se it is more up-to-date (number of small corrections made following > comments from readers). > > So it would take you just a few minutes (at no cost) to download it and > start enjoying it. > > Cheers, > Laurent. > > Le mar. 11 sept. 2018 à 13:26, ToddAndMargo a > écrit :

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Laurent Rosenfeld via perl6-users
Le mar. 11 sept. 2018 à 13:26, ToddAndMargo a écrit : > Hi All, > > Not to beat a dead horse, but Perl 6's docs are > miserably hard to understand. > > Here is a comparison of Perl 5's perldocs and Perl 6's > docs: > > Perl 5: > > $ perldoc -f

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Tom Browder
Todd, some free advice: 1. DOCUMENTATION The docs are a volunteer effort. You can help by contributing changes and submitting issues. Try to use the docs first instead of using an internet search. That will help you submit issues if you don't find what you are looking for. You really ne

A comparison between P5 docs and p6 docs

2018-09-11 Thread ToddAndMargo
Hi All, Not to beat a dead horse, but Perl 6's docs are miserably hard to understand. Here is a comparison of Perl 5's perldocs and Perl 6's docs: Perl 5: $ perldoc -f index index STR,SUBSTR,POSITION index STR,SUBSTR The index function searches for one string

[perl6/specs] bc769f: Add removed docs commit

2017-04-17 Thread GitHub
v6d.pod Log Message: --- Add removed docs commit for salvagin later

Re: Perl 6 docs

2017-03-25 Thread Shlomi Fish
On Sat, 25 Mar 2017 16:49:04 +0100 Gabor Szabo wrote: > https://github.com/perl6/doc/issues/1257 Thanks for clarifying!

Re: Perl 6 docs

2017-03-25 Thread Gabor Szabo
https://github.com/perl6/doc/issues/1257

Re: Perl 6 docs

2017-03-25 Thread Shlomi Fish
Hi Gabor, On Sat, 25 Mar 2017 13:36:31 +0100 Gabor Szabo wrote: > When I search for %INC at https://docs.perl6.org/ it offers "%INC (Perl 5)" > but when I search for the more common @INC > Your sentence appears to be cut in the middle - I cannot understand it. Can you clarify? > Luckily the

Re: Perl 6 docs

2017-03-25 Thread Will Coleda
Please open an issue at https://github.com/perl6/doc/issues so it gets tracked, thanks! On Sat, Mar 25, 2017 at 8:36 AM, Gabor Szabo wrote: > When I search for %INC at https://docs.perl6.org/ it offers "%INC (Perl 5)" > but when I search for the more common @INC > > Luckily the former leads to

Perl 6 docs

2017-03-25 Thread Gabor Szabo
When I search for %INC at https://docs.perl6.org/ it offers "%INC (Perl 5)" but when I search for the more common @INC Luckily the former leads to https://docs.perl6.org/language/5to6-perlvar which also has information on the latter, but it would be nice if that was also recognized in the search

[perl #129246] [DOCS] bad link to "Slurpy Arguments" at https://docs.perl6.org/type/Signature#Constraining_Slurpy_Arguments

2016-09-10 Thread via RT
# New Ticket Created by Brandon Allbery # Please include the string: [perl #129246] # in the subject line of all future correspondence about this issue. # https://rt.perl.org/Ticket/Display.html?id=129246 > It goes to https://docs.perl6.org/type/Slurpy_(A$FULL_STOPK$FULL_STOPA$FULL_STOP_Varia

[perl #128801] Perl 6 docs don't mention pragmas in a doc search

2016-08-01 Thread via RT
# New Ticket Created by Tom Browder # Please include the string: [perl #128801] # in the subject line of all future correspondence about this issue. # https://rt.perl.org/Ticket/Display.html?id=128801 > This transaction appears to have no content

Re: [BUG] Rakudo docs not converted to man nor installed for "make install"

2016-05-10 Thread Tom Browder
On Tuesday, May 10, 2016, Sam S. via RT wrote: > What docs? > > The ones in the 'docs/' folder in the git repo? > Those seem to be project docs aimed at developers working on Rakudo, not > at users of Rakudo. > I.e. that folder is basically used as a project wiki.

[perl #128087] [BUG] Rakudo docs not converted to man nor installed for "make install"

2016-05-06 Thread via RT
# New Ticket Created by Tom Browder # Please include the string: [perl #128087] # in the subject line of all future correspondence about this issue. # https://rt.perl.org/Ticket/Display.html?id=128087 > This is Rakudo version 2016.04 built on MoarVM version 2016.04 implementing Perl 6.c.

Re: Two topics not found in docs search: 'constant' and 'heredocs'.

2016-04-04 Thread Tom Browder
On Mon, Apr 4, 2016 at 7:41 AM, Timo Paulssen wrote: ... > I think you'd have to use the X tag in the pod source to create an index > entry that the search feature would then allow you to use. Pull request submitted and accepted to add the two items. -Tom

Re: Two topics not found in docs search: 'constant' and 'heredocs'.

2016-04-04 Thread Tom Browder
On Mon, Apr 4, 2016 at 7:41 AM, Timo Paulssen wrote: > On 04/04/16 13:42, Shlomi Fish wrote: >> How are you searching exactly? With which command/which URL? > Probably the search field on the doc page. Precisely. -Tom

Re: Two topics not found in docs search: 'constant' and 'heredocs'.

2016-04-04 Thread Tom Browder
On Mon, Apr 4, 2016 at 7:41 AM, Timo Paulssen wrote: > On 04/04/16 13:42, Shlomi Fish wrote: ... > I think you'd have to use the X tag in the pod source to create an index > entry that the search feature would then allow you to use. Thanks. -Tom

Re: Two topics not found in docs search: 'constant' and 'heredocs'.

2016-04-04 Thread Timo Paulssen
On 04/04/16 13:42, Shlomi Fish wrote: How are you searching exactly? With which command/which URL? -- Shlomi Probably the search field on the doc page. I can reproduce both terms not giving any results there. I think you'd have to use the X tag in the pod source to create an index

Re: Two topics not found in docs search: 'constant' and 'heredocs'.

2016-04-04 Thread Shlomi Fish
edocs%3A_%3Ato > > but neither is listed when doing a search. > How are you searching exactly? With which command/which URL? -- Shlomi > And how does one make a phrase or term searchable in the docs anyway? > > Thanks. > > Best regards, > > -Tom

Two topics not found in docs search: 'constant' and 'heredocs'.

2016-04-04 Thread Tom Browder
The declarator "constant" is found here: http://doc.perl6.org/language/5to6-nutshell#constant And "Heredocs" are discussed here: http://doc.perl6.org/language/quoting#Heredocs%3A_%3Ato but neither is listed when doing a search. And how does one make a phrase or term se

[perl6/specs] 33eaff: Update Supply introduction and method docs for ser...

2016-02-26 Thread GitHub
-concurrency.pod Log Message: --- Update Supply introduction and method docs for serial supplies Also some Channel clarifications. Commit: cc534c403199b0804fe05bd5cb88676142a878a1 https://github.com/perl6/specs/commit/cc534c403199b0804fe05bd5cb88676142a878a1 Author: skids

[perl6/specs] 4c608a: Sync design docs to Supply/Supplier split

2015-12-07 Thread GitHub
-concurrency.pod Log Message: --- Sync design docs to Supply/Supplier split

Re: [perl #126202] LTA results for trailing declarative docs

2015-09-27 Thread Parrot Raiser
Change " class Foo { method bar { } #= baz " to " class Foo { method bar { } #= Some comment about Foo "? On 9/26/15, Rob Hoelz wrote: > # New Ticket Created by Rob Hoelz > # Please include the string: [perl #126202] > # in the subject line of all future correspondence about this issue. > # h

[perl #126202] LTA results for trailing declarative docs

2015-09-26 Thread via RT
# New Ticket Created by Rob Hoelz # Please include the string: [perl #126202] # in the subject line of all future correspondence about this issue. # https://rt.perl.org/Ticket/Display.html?id=126202 > In this example: class Foo { method bar { } #= baz }; say Foo.^find_method('ba

Re: Proposed docs for C

2015-09-16 Thread David H. Adler
On Wed, Sep 16, 2015 at 04:42:27PM -0400, Parrot Raiser wrote: > On 9/16/15, David H. Adler wrote: > > > So, how about this > > > > perl6 -e 'sub a {state @x; @x.push(++$)}; say a for 1..6;' > > > > [1] > > [1 2] > > &c > > Even better, but how about 'for a..f'? That makes it clear that the > li

Re: Proposed docs for C

2015-09-16 Thread Parrot Raiser
On 9/16/15, David H. Adler wrote: > So, how about this > > perl6 -e 'sub a {state @x; @x.push(++$)}; say a for 1..6;' > > [1] > [1 2] > &c Even better, but how about 'for a..f'? That makes it clear that the list values are being used, not some sort of subscript. (The less ambiguity possible in a

Re: Proposed docs for C

2015-09-16 Thread David H. Adler
On Tue, Sep 15, 2015 at 11:28:59AM -0500, andy_b...@wiwb.uscourts.gov wrote: > [1 1 1 1] > next > [1 1 1 1 1 1] > next > [1 1 1 1 1 1 1 1] > > vs > > [1 2 3] > next > [1 2 3 3] > next > [1 2 3 3 3] > > I think the latter is clearer, though perhaps the problem is the original > code is a bit ove

Re: Proposed docs for C

2015-09-15 Thread Andy_Bach
[1 1 1 1] next [1 1 1 1 1 1] next [1 1 1 1 1 1 1 1] vs [1 2 3] next [1 2 3 3] next [1 2 3 3 3] I think the latter is clearer, though perhaps the problem is the original code is a bit overly-contrived (I'm thinking ;-). It shows better the variation after each call, maybe. my 2.00e-02 dolla

Re: Proposed docs for C

2015-09-15 Thread Parrot Raiser
The combination of different numbers on separate lines looks clearest to me. On 9/14/15, yary wrote: > Keep it on separate lines, I don't know how that formatting got lost (it's > showing up as separate lines in my history). > > As for the rest of it, curious as to consensus. > > -y > > On Mon, S

Re: Proposed docs for C

2015-09-14 Thread yary
Keep it on separate lines, I don't know how that formatting got lost (it's showing up as separate lines in my history). As for the rest of it, curious as to consensus. -y On Mon, Sep 14, 2015 at 4:06 PM, David H. Adler wrote: > On Mon, Sep 14, 2015 at 03:13:21PM -0400, yary wrote: > > Using d

Re: Proposed docs for C

2015-09-14 Thread David H. Adler
On Mon, Sep 14, 2015 at 03:13:21PM -0400, yary wrote: > Using different numbers for the examples helps visualize what's > initialized vs added later: ... > *[1 2 3]next[1 2 3 3]next[1 2 3 3 3]* I don't know. I think, by having it on separate lines, and watching the row of '1's extend, is less vi

  1   2   3   4   5   6   7   8   9   10   >