2009-10-09 04:54:41 -04:00 
										
									 
								 
							 
							
								
							 
							
								 
							 
							
							
								< html > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< head > < title > Factor< / title > < / head > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< body > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< h1 > The Factor programming language< / h1 > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< h2 > Getting started< / h2 > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< p > If you are reading this README file, you either downloaded a binary
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								package, or checked out Factor sources from the GIT repository.< / p > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< ul > 
							 
						 
					
						
							
								
									
										
										
										
											2011-03-05 07:36:29 -05:00 
										
									 
								 
							 
							
								
									
										 
									 
								
							 
							
								 
							 
							
							
								< li > < a  href = "http://concatenative.org/wiki/view/Factor/Learning" > Learning Factor< / a > < / li > 
							 
						 
					
						
							
								
									
										
										
										
											2009-10-09 04:54:41 -04:00 
										
									 
								 
							 
							
								
							 
							
								 
							 
							
							
								< li > < a  href = "http://concatenative.org/wiki/view/Factor/Requirements" > System requirements< / a > < / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < a  href = "http://concatenative.org/wiki/view/Factor/Building%20Factor" > Building Factor from source< / a >  (don't do this if you're using a binary package)< / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< / ul > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< p > To run Factor:< p > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< ul > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > Windows: Double-click < code > factor.exe< / code > , or run
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< code > .\factor.com< / code >  in a command prompt< / li > 
							 
						 
					
						
							
								
									
										
										
										
											2009-10-28 22:03:53 -04:00 
										
									 
								 
							 
							
								
									
										 
									 
								
							 
							
								 
							 
							
							
								< li > Mac OS X: Double-click < code > Factor.app< / code >  or run < code > open
							 
						 
					
						
							
								
									
										
										
										
											2009-10-09 04:54:41 -04:00 
										
									 
								 
							 
							
								
							 
							
								 
							 
							
							
								Factor.app< / code >  in a Terminal< / li > 
							 
						 
					
						
							
								
									
										
										
										
											2009-10-28 22:03:53 -04:00 
										
									 
								 
							 
							
								
									
										 
									 
								
							 
							
								 
							 
							
							
								< li > Unix: Run < code > ./factor< / code >  in a shell< / li > 
							 
						 
					
						
							
								
									
										
										
										
											2009-10-09 04:54:41 -04:00 
										
									 
								 
							 
							
								
							 
							
								 
							 
							
							
								< / ul > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< h2 > Documentation< / h2 > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< p > The Factor environment includes extensive reference documentation and
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								a short "cookbook" to help you get started. The best way to read the
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								documentation is in the UI; press F1 in the UI listener to open the help
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								browser tool. You can also < a  href = "http://docs.factorcode.org" > browse
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								the documentation online< / a > .< / p > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< h2 > Command line usage< / h2 > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< p > Factor supports a number of command line switches. To read command line
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								usage documentation, enter the following in the UI listener:< / p > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< pre > "command-line" about< / pre > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< h2 > Source organization< / h2 > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								The Factor source tree is organized as follows:
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < code > build-support/< / code >  - scripts used for compiling Factor (not
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								present in binary packages)< / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < code > vm/< / code >  - Factor VM source code (not present in binary
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								packages)< / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < code > core/< / code >  - Factor core library< / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < code > basis/< / code >  - Factor basis library, compiler, tools< / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < code > extra/< / code >  - more libraries and applications< / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < code > misc/< / code >  - editor modes, icons, etc< / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < code > unmaintained/< / code >  - unmaintained contributions, please
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								help!< / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< h2 > Community< / h2 > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< p > Factor developers meet in the < code > #concatenative< / code >  channel on < a 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								href="http://freenode.net">irc.freenode.net< / a > . Drop by if you want to discuss
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								anything related to Factor or language design in general.< / p > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< ul > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < a  href = "http://factorcode.org" > Factor homepage< / a > < / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< li > < a  href = "http://concatenative.org" > Concatenative languages wiki< / a > < / li > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< / ul > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< p > Have fun!< / p > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< / body > 
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							 
							
							
								< / html >