[Factor-talk] Comments on 'Your First Program'
Hi I'm very new to factor - around 2 days - so I hope you don't mind me mailing so early. I have some comments/improvements/corrections not sure which) to the series of docs entitled Getting Started / Your First Program (i.e the palindrome stuff). Should I post them here, or discuss them with the author? Who would that be? Best Wishes Mike -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Comments on 'Your First Program'
This is a good place, the tutorial has had a few contributors to it and we welcome more - and questions, too! If you want to submit your improvements here or through Github, either is fine. Best, John. On Fri, Aug 31, 2012 at 1:52 AM, Mike Parr mikep...@live.com wrote: Hi I'm very new to factor - around 2 days - so I hope you don't mind me mailing so early. I have some comments/improvements/corrections not sure which) to the series of docs entitled Getting Started / Your First Program (i.e the palindrome stuff). Should I post them here, or discuss them with the author? Who would that be? Best Wishes Mike -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Comments on 'Your First Program
OK, here are some suggestions for the 'Getting Started - Your First program' stuff - the palindrome. I am using Windows 7. 'Creating a vocabulary...' Excellent 'Writing some logic in your first program' After it says 'Place this definition at the end of your source file.' I suggest adding: 'Note that a space is significant in Factor.' Where it says: 'Enter dup in the listener's input area, and press C+h.' This didn't work, so I wondered what C+h actually meant. I have never seen Ctrl and Alt shortened to C and A before. It turned out that I had to highlight dup, so I suggest replace the sentence by: 'Enter dup in the listener's input area, highlight it, then press Ctrl+h.' Near the bottom... 'Finally, check... added to the search path.' At this stage, there may be errors, and it would be useful to see what the exact complete code should look like. I suggest copying the 6 lines of code from the testing section below, and adding them here as well. 'Testing your first program' Where it says: 'A more advanced technique which comes into play with larger programs is Unit Testing.' The page then goes on to describe unit testing, but the section is not headed, so I suggest: 'A more advanced ...larger programs is Unit Testing, as follows.' (In fact, the above stuff on the page does an interactive unit test, so I would prefer the phrase 'automated unit testing' personally.) 'Create a test harness using the scaffold tool: palindrome scaffold-tests ' The above did not work, and I suggest adding the line: USE: tools.scaffold 'It should report that all the tests have passed.' no... it did not display a message if all the tests passed. It only reports if a test fails. So, I suggest: 'If a test fails, a warning message is displayed.' That's as far as I got. Please excuse any Factor howlers! Mike ___ http://www.mikeparr.info/ ___ -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Comments on 'Your First Program
Hi Mike, Great input, thanks! A few questions - 'Writing some logic in your first program' After it says 'Place this definition at the end of your source file.' I suggest adding: 'Note that a space is significant in Factor.' What exactly are you trying to communicate with this -- that we require spaces to tokenize? Multiple spaces are treated the same as a single space, indentation doesn't matter (although tabs are disallowed as blank characters). Where it says: 'Enter dup in the listener's input area, and press C+h.' This didn't work, so I wondered what C+h actually meant. I have never seen Ctrl and Alt shortened to C and A before. It turned out that I had to highlight dup, so I suggest replace the sentence by: 'Enter dup in the listener's input area, highlight it, then press Ctrl+h.' You can also position your cursor on or immediately after the word you want to Ctrl+h. Best, John. -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Comments on 'Your First Program
Just thought I would mention that there is no Ctrl key on the Mac, so this change might not be so good for the Mac folks. Sent from my iPhone On Aug 31, 2012, at 6:47 PM, John Benediktsson mrj...@gmail.com wrote: Hi Mike, Great input, thanks! A few questions - 'Writing some logic in your first program' After it says 'Place this definition at the end of your source file.' I suggest adding: 'Note that a space is significant in Factor.' What exactly are you trying to communicate with this -- that we require spaces to tokenize? Multiple spaces are treated the same as a single space, indentation doesn't matter (although tabs are disallowed as blank characters). Where it says: 'Enter dup in the listener's input area, and press C+h.' This didn't work, so I wondered what C+h actually meant. I have never seen Ctrl and Alt shortened to C and A before. It turned out that I had to highlight dup, so I suggest replace the sentence by: 'Enter dup in the listener's input area, highlight it, then press Ctrl+h.' You can also position your cursor on or immediately after the word you want to Ctrl+h. Best, John. -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Comments on 'Your First Program
On Fri, Aug 31, 2012 at 5:19 PM, Michael Clagett mclag...@hotmail.com wrote: Just thought I would mention that there is no Ctrl key on the Mac, so this change might not be so good for the Mac folks. Yes, there is. (Unless you mean the original Mac 128k and 512k, which Factor does not yet support.) -Joe -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Comments on 'Your First Program
I just meant that it's not called control, it's called command. So you could probably get by with something like Ctrl(Cmd)-C. Or Cmd(Ctrl)-C, if you favor Macs. Or you could stick with the C-c and just explain somewhere at the top that on a PC that means Control and on a Mac it means Command. Not a big deal, just thought you might want to make it completely clear to everyone. Date: Fri, 31 Aug 2012 17:39:49 -0700 From: arc...@gmail.com To: factor-talk@lists.sourceforge.net Subject: Re: [Factor-talk] Comments on 'Your First Program On Fri, Aug 31, 2012 at 5:19 PM, Michael Clagett mclag...@hotmail.com wrote: Just thought I would mention that there is no Ctrl key on the Mac, so this change might not be so good for the Mac folks. Yes, there is. (Unless you mean the original Mac 128k and 512k, which Factor does not yet support.) -Joe -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Comments on 'Your First Program
On Fri, Aug 31, 2012 at 6:25 PM, Michael Clagett mclag...@hotmail.com wrote: I just meant that it's not called control, it's called command. So you could probably get by with something like Ctrl(Cmd)-C. Or Cmd(Ctrl)-C, if you favor Macs. Or you could stick with the C-c and just explain somewhere at the top that on a PC that means Control and on a Mac it means Command. Not a big deal, just thought you might want to make it completely clear to everyone. Ctrl and Cmd are different keys. -Joe -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Comments on 'Your First Program
Okay, never mind. Not being a Mac guy, I must not understand it well enough. But on my wife's and daughter's MacBook Pros I usually find that Command + some key is roughly equivalent to Ctrl + the same key on the PC. Never noticed that there was also a Ctrl key. Sorry for the noise. Date: Fri, 31 Aug 2012 18:29:35 -0700 From: arc...@gmail.com To: factor-talk@lists.sourceforge.net Subject: Re: [Factor-talk] Comments on 'Your First Program On Fri, Aug 31, 2012 at 6:25 PM, Michael Clagett mclag...@hotmail.com wrote: I just meant that it's not called control, it's called command. So you could probably get by with something like Ctrl(Cmd)-C. Or Cmd(Ctrl)-C, if you favor Macs. Or you could stick with the C-c and just explain somewhere at the top that on a PC that means Control and on a Mac it means Command. Not a big deal, just thought you might want to make it completely clear to everyone. Ctrl and Cmd are different keys. -Joe -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
Re: [Factor-talk] Comments on 'Your First Program
On Fri, Aug 31, 2012 at 6:33 PM, Michael Clagett mclag...@hotmail.com wrote: Okay, never mind. Not being a Mac guy, I must not understand it well enough. But on my wife's and daughter's MacBook Pros I usually find that Command + some key is roughly equivalent to Ctrl + the same key on the PC. Never noticed that there was also a Ctrl key. Sorry for the noise. Well, to address your concern about platform-specific bindings: The Factor documentation markup has rules for displaying command keyboard shortcuts by command name, so that the key bound to a command is displayed. On OS X it even uses the funny symbols for shift/ctrl/option/cmd. The Factor UI doesn't currently have many platform-specific bindings, instead preferring the one-size-fits-none approach, but if it did, the help system is ready for it. -Joe -- Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ ___ Factor-talk mailing list Factor-talk@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/factor-talk
