Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 7 additions & 9 deletions docs/INSTALLATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,22 @@

The Factor track uses **Factor 0.101**. Earlier versions are not supported.

You can either install a [nightly](#nightly) build (which tracks 0.101+ from `master`) or [build from source](#autobuild-from-source).
You can install a [stable](#stable) or [nightly](#nightly) build, or [build from source](#build-from-source).

Verify your installation by running `factor -e='vm-version print'` — it should print `0.101` or higher.

---
### Stable

<http://factorcode.org> provides stable binaries under the "Stable release" section.

---
### Nightly

<http://factorcode.org> provides nightly binaries under the "Development release" section. These binaries are built from git, but only builds that pass are shown.

---

### (Auto)build from source
### build from source

If you want the bleeding edge and even nightly is too old for you, then you will need a modern C++ compiler (GCC >=4.8 or Clang >=3.5), `make`, and `curl`.

Expand Down Expand Up @@ -65,9 +69,3 @@ Clone the [repository](https://github.com/factor/factor) and use `make` in that
If `make` fails with an error about a non-present target, try `make factor` or, if you can read a Makefile, find the make target for your platform in `GNUmakefile`.

If *that* fails, open an issue on [factor/factor](https://github.com/factor/factor) containing the error -- the friendly developers will be happy to help.

---

#### Stable (not recommended)

**Stable releases predate Factor 0.101 and are not supported.** Use a [nightly build](#nightly) or build from source.
6 changes: 0 additions & 6 deletions docs/LEARNING.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,6 @@ There are many great resources for learning Factor.

* Documentation is an important part of every good Factor vocabulary. Consequently, Factor's amazing and extensive docs are available offline, searchable right from the GUI Listener, or on the command line. These same docs, equally searchable, can be found online. <br /> <https://docs.factorcode.org>

* Factor's GitHub repository hosts a Wiki. <br /> <https://github.com/factor/factor/wiki>

* Björn Lindqvist, one of Factor's developers, has a repo full of interesting tips and tricks. It's not updated very often and is WIP (and much of its content is being moved to the GitHub Wiki), but it's still very cool stuff. <br /> <https://github.com/bjourne/playground-factor>

* [Learn X in Y Minutes][learn-x-in-y-minutes] is a good resource for many languages, and Factor is no exception. Its tutorial is not *extensive* by any means, but it is a good reference and enough to get you started. <br /> <https://learnxinyminutes.com/docs/factor>
Expand All @@ -20,8 +18,6 @@ There are many great resources for learning Factor.

Lastly and maybe leastly,

* The [Concatenative Wiki][concatenative-wiki]. Note that while it has good content and it's not wrong by any means, it's not really updated and [is being phased out][phasing-out] in favour of the GitHub Wiki above.

* [Stack Overflow][stack-overflow]. There's not a large community (okay, about three users including yours truly) but ask there if you're really, truly stuck and someone will surely help you out.

* The [Mailing List][mailing-list]. Here, you can ask about anything Factor-related and a collaborator will answer helpfully.
Expand All @@ -40,8 +36,6 @@ Finally, Factor is written almost entirely in Factor. So, read the source code,
[rosetta-code]: https://rosettacode.org/wiki/Rosetta_Code
[chrestomathy]: https://en.wikipedia.org/wiki/Chrestomathy
[rosetta-code-factor]: https://rosettacode.org/wiki/Category:Factor
[concatenative-wiki]: https://concatenative.org/wiki/view/Factor
[phasing-out]: https://github.com/factor/factor/issues/706
[stack-overflow]: https://stackoverflow.com/questions/tagged/factor-lang
[mailing-list]: https://concatenative.org/wiki/view/Factor/Mailing%20list
[irc-channel]: https://concatenative.org/wiki/view/Concatenative%20IRC%20channel
Expand Down
2 changes: 0 additions & 2 deletions docs/RESOURCES.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@
* [Andrea Ferretti's Factor tutorial][ferretti-tutorial].
* "[Factor in 2022][factor-in-2022]", a talk by John Benediktsson and Doug Coleman.
* *[Thinking Forth][thinking-forth]* by Leo Brodie — on the concatenative, stack-oriented mindset.
* The [Factor GitHub Repository Wiki][github-wiki].
* [Björn Lindqvist's Factor Playground][playground-factor].
* [Learn X in Y Minutes, where X = Factor][learn-x-in-y-minutes].
* [Factor on RosettaCode][rosetta-code].
Expand All @@ -21,7 +20,6 @@
[ferretti-tutorial]: https://andreaferretti.github.io/factor-tutorial/
[factor-in-2022]: https://www.youtube.com/watch?v=OLh61q4c4XE
[thinking-forth]: https://thinking-forth.sourceforge.net/
[github-wiki]: https://github.com/factor/factor/wiki
[playground-factor]: https://github.com/bjourne/playground-factor
[learn-x-in-y-minutes]: https://learnxinyminutes.com/docs/factor
[rosetta-code]: https://rosettacode.org/wiki/Category:Factor
Expand Down
4 changes: 2 additions & 2 deletions docs/TESTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,10 +22,10 @@ The Factor track uses **Factor 0.101**. Each exercise ships with a small bundled
factor -roots=. -run=exercism-tools <exercise-slug>
```

For example, to run the `annalyns-infiltration` tests:
For example, to run the `hello-world` tests:

```
factor -roots=. -run=exercism-tools annalyns-infiltration
factor -roots=. -run=exercism-tools hello-world
```

The runner exits with status 0 when all tests pass, and non-zero with diagnostic output when any test fails.
Expand Down
9 changes: 4 additions & 5 deletions exercises/shared/.docs/help.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,10 @@ run from this exercise's directory:
factor -roots=. -run=exercism-tools <exercise-slug>
```

For example, for `annalyns-infiltration`:
For example, for `hello-world`:

```
factor -roots=. -run=exercism-tools annalyns-infiltration
factor -roots=. -run=exercism-tools hello-world
```

Each exercise ships a small bundled `exercism-tools` vocabulary
Expand Down Expand Up @@ -49,7 +49,7 @@ exercism submit <exercise-slug>/<exercise-slug>.factor
For example:

```
exercism submit annalyns-infiltration/annalyns-infiltration.factor
exercism submit hello-world/hello-world.factor
```

If the exercise's `.meta/config.json` lists more than one
Expand All @@ -69,8 +69,7 @@ mentor feedback on whatever you have so far.
is the best place for track-specific questions and feedback.
- The [Exercism Discord](https://exercism.org/r/discord) has
channels for both general help and individual tracks.
- [Factor's official documentation](https://docs.factorcode.org/)
is searchable and exhaustive. Two good entry points:
- Factor's official documentation is searchable and exhaustive. Two good entry points:
- [The Factor handbook](https://docs.factorcode.org/content/article-handbook.html)
— reference-style, organised by vocabulary.
- [The Factor cookbook](https://docs.factorcode.org/content/article-cookbook.html)
Expand Down
4 changes: 2 additions & 2 deletions exercises/shared/.docs/tests.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@ The Factor track uses **Factor 0.101**. Each exercise ships with a bundled `exer
factor -roots=. -run=exercism-tools <exercise-slug>
```

For example, for the `annalyns-infiltration` exercise:
For example, for the `hello-world` exercise:

```
factor -roots=. -run=exercism-tools annalyns-infiltration
factor -roots=. -run=exercism-tools hello-world
```

The runner exits with status 0 when all tests pass, and non-zero with diagnostic output when any test fails.
Expand Down