[Factor-talk] Printing the docs
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
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
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
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
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
Re: [Factor-talk] Graphviz unit tests
- The current tests pass on my machine. But then, my machine = a Debian box with Graphviz 2.26.3 installed (since I guess 2.28 is too bleeding-edge for Debian) and erg's plugin-list fix reverted (which I'm certainly thankful for, but 2.26 doesn't have the gvPluginList function; ugh). So, grain of salt I guess. I get a kernel-error trying to run the first smoke-test (5 K_n), with Graphviz 2.28.0 on Mac OS X 10.7.1 x86_64. And running graphviz test causes Factor to quit unexpectedly... which might be a different bug? -- BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA Learn about the latest advances in developing for the BlackBerryreg; mobile platform with sessions, labs more. See new tools and technologies. Register for BlackBerryreg; DevCon today! http://p.sf.net/sfu/rim-devcon-copy1 ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Graphviz unit tests
I get a kernel-error trying to run the first smoke-test (5 K_n), with Graphviz 2.28.0 on Mac OS X 10.7.1 x86_64. And running graphviz test causes Factor to quit unexpectedly... which might be a different bug? I hate Graphviz. I really, really do. I'm not sure about the kernel-error, but if the unexpected quitting is anything like previous issues I've come across, their source code habitually calls exit(), which kills the UI listener since they share the same process (I experimented once with forking the FFI calls, but that's a no-go on Windows, so). If you -run=listener to test, you might be able to see if a message gets printed by Graphviz to stderr. Maybe that'll give us more info? (If it's further similar to other problems I've had with Graphviz, the error message will be a single line buried in some undocumented corner of some messy source code that hasn't been discussed anywhere that's indexed by Google. Joy. I hope for Graphviz's sake that I'm just really incompetent at reading C code.) Thanks for testing, --Alex Vondrak -- BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA Learn about the latest advances in developing for the BlackBerryreg; mobile platform with sessions, labs more. See new tools and technologies. Register for BlackBerryreg; DevCon today! http://p.sf.net/sfu/rim-devcon-copy1 ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Graphviz unit tests
Unfortunately, this is all I get from the command-line. I'll need to do more debugging at some point: ( scratchpad ) USE: graphviz ( scratchpad ) graphviz test Unit Test: { { t } [ 5 K_n smoke-test ] } factor(53761,0x7fff7512c960) malloc: *** error for object 0xc000: pointer being freed was not allocated *** set a breakpoint in malloc_error_break to debug Abort trap: 6 On Sun, Sep 18, 2011 at 7:43 PM, Alexander James Vondrak ajvond...@csupomona.edu wrote: I get a kernel-error trying to run the first smoke-test (5 K_n), with Graphviz 2.28.0 on Mac OS X 10.7.1 x86_64. And running graphviz test causes Factor to quit unexpectedly... which might be a different bug? I hate Graphviz. I really, really do. I'm not sure about the kernel-error, but if the unexpected quitting is anything like previous issues I've come across, their source code habitually calls exit(), which kills the UI listener since they share the same process (I experimented once with forking the FFI calls, but that's a no-go on Windows, so). If you -run=listener to test, you might be able to see if a message gets printed by Graphviz to stderr. Maybe that'll give us more info? (If it's further similar to other problems I've had with Graphviz, the error message will be a single line buried in some undocumented corner of some messy source code that hasn't been discussed anywhere that's indexed by Google. Joy. I hope for Graphviz's sake that I'm just really incompetent at reading C code.) Thanks for testing, --Alex Vondrak -- BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA Learn about the latest advances in developing for the BlackBerryreg; mobile platform with sessions, labs more. See new tools and technologies. Register for BlackBerryreg; DevCon today! http://p.sf.net/sfu/rim-devcon-copy1 ___ 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 Learn about the latest advances in developing for the BlackBerryreg; mobile platform with sessions, labs more. See new tools and technologies. Register for BlackBerryreg; DevCon today! http://p.sf.net/sfu/rim-devcon-copy1 ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk