[Factor-talk] Printing the docs

2011-09-18 Thread Patrick Mc(avery
I would like a hard copy of the documentation and I asked for help on 
the IRC last night and got some help:

  documentation is in **/*-docs.factor. you can run USE: help.html 
generate-help to generate HTML help, which will give you the same thing 
that's on docs.factorcode.org

I tried to run this in the listener but if it generated the 
documentation in a folder I can't find it.

Sorry to be so dumb, if someone could tell me how to print the 
documentation I promise not to ask so many dumb question :)

-Patrick

--
BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA
http://p.sf.net/sfu/rim-devcon-copy2
___
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk


Re: [Factor-talk] Printing the docs

2011-09-18 Thread Joe Groff

On Sep 18, 2011, at 9:54 AM, Patrick Mc(avery patr...@spellingbeewinnars.org 
wrote:

 I would like a hard copy of the documentation and I asked for help on 
 the IRC last night and got some help:
 
  documentation is in **/*-docs.factor. you can run USE: help.html 
 generate-help to generate HTML help, which will give you the same thing 
 that's on docs.factorcode.org
 
 I tried to run this in the listener but if it generated the 
 documentation in a folder I can't find it.

It looks like the files are generated into temp/docs under the Factor 
directory.

-Joe

smime.p7s
Description: S/MIME cryptographic signature
--
BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA
http://p.sf.net/sfu/rim-devcon-copy2___
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk


Re: [Factor-talk] Printing the docs

2011-09-18 Thread John Benediktsson
Which parts of the documentation are you looking for?  I wrote some code to
generate PDF's from parts of the Factor documentation:

 First Program ( first-program help )
 https://github.com/mrjbq7/re-factor/raw/master/docs/first-program.pdf

 Cookbook ( cookbook help )
 https://github.com/mrjbq7/re-factor/raw/master/docs/cookbook.pdf

 Language ( handbook-language-reference help )
 https://github.com/mrjbq7/re-factor/raw/master/docs/handbook.pdf

 System ( handbook-system-reference help )
 https://github.com/mrjbq7/re-factor/raw/master/docs/system.pdf

 Tools ( handbook-tools-reference help )
 https://github.com/mrjbq7/re-factor/raw/master/docs/tools.pdf

Best,
John.


On Sun, Sep 18, 2011 at 9:54 AM, Patrick Mc(avery 
patr...@spellingbeewinnars.org wrote:

 I would like a hard copy of the documentation and I asked for help on
 the IRC last night and got some help:

  documentation is in **/*-docs.factor. you can run USE: help.html
 generate-help to generate HTML help, which will give you the same thing
 that's on docs.factorcode.org

 I tried to run this in the listener but if it generated the
 documentation in a folder I can't find it.

 Sorry to be so dumb, if someone could tell me how to print the
 documentation I promise not to ask so many dumb question :)

 -Patrick


 --
 BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA
 http://p.sf.net/sfu/rim-devcon-copy2
 ___
 Factor-talk mailing list
 Factor-talk@lists.sourceforge.net
 https://lists.sourceforge.net/lists/listinfo/factor-talk

--
BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA
http://p.sf.net/sfu/rim-devcon-copy2___
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk


Re: [Factor-talk] Printing the docs

2011-09-18 Thread Patrick Mc(avery
On 11-09-18 03:11 PM, John Benediktsson wrote:
 Which parts of the documentation are you looking for?  I wrote some 
 code to generate PDF's from parts of the Factor documentation:

[ snip ]
 Best,
 John.

Hi John

This is a big help thanks! This will keep me busy for a while.

I was planning on printing all of the documentation but thanks to Joe 
and the fellow on IRC I have a folder of html documents and I can see 
there is a crap-load of documentation here(how did you guys even write 
this?). I was also thinking about printing out all of the factor files 
in the source but it looks like it would be 4600 pages. At 30 cents a 
sheet for colour(I like syntax highlighting) that would kill my 
wallet(actually several wallets) and a tree too :)


I'm not joking, I am thinking about factor at night when I dream, it's 
absolutely fascinating but I am having a hard time learning it. With 
most languages you can learn the core first and the libraries later, 
with factor the line between the two is fuzzy and it seems like a full 
blown effort is required. -Patrick




--
BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA
http://p.sf.net/sfu/rim-devcon-copy2
___
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk


Re: [Factor-talk] Printing the docs

2011-09-18 Thread Joe Groff

On Sep 18, 2011, at 3:03 PM, Patrick Mc(avery patr...@spellingbeewinnars.org 
wrote:

 I'm not joking, I am thinking about factor at night when I dream, it's 
 absolutely fascinating but I am having a hard time learning it. With 
 most languages you can learn the core first and the libraries later, 
 with factor the line between the two is fuzzy and it seems like a full 
 blown effort is required. -Patrick

Trying to learn all the libraries before using Factor is like trying to learn 
all of CPAN before using Perl (or Hackage before using Haskell, or PyPI before 
using Python—pick your favorite). Try picking a problem to solve in Factor and 
you can learn the libraries as you go. As John recommended, the contents of 
core/ are a decent definition for core language—that's the essential part of 
Factor that it requires to bootstrap itself.

-Joe

smime.p7s
Description: S/MIME cryptographic signature
--
BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA
http://p.sf.net/sfu/rim-devcon-copy2___
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk