Table of Contents
Post-getting started guide
Installing packages
By itself, Wonderful provides only a package manager - installing further packages requires using wf-pacman
.
- To install the wswan target, run
wf-pacman -S target-wswan
.
Some tools are packaged separately from any target. For example, to install wf-superfamiconv
, run wf-pacman -S wf-superfamiconv
.
Remember that each target and toolchain may have additional libraries! To discover them, use commands like wf-pacman -Ss target-wswan
or wf-pacman -Ss toolchain-gcc-arm-none-eabi
.
Configuring environment variables
To make accessing Wonderful easy, you may want to pre-populate the environment variables in your shell on launch:
- For bash, add
source /opt/wonderful/bin/wf-env
to your~/.profile
. - For fish, add
. /opt/wonderful/bin/wf-env.fish
to your Fish configuration. - For zsh, add
source /opt/wonderful/bin/wf-env
to your~/.zprofile
.
Alternatively, you may want to alias wf-env
to allow them to be easily added when needed:
- For bash, add
alias wf-env='source /opt/wonderful/bin/wf-env'
to your~/.profile
. - For fish, add
alias wf-env . /opt/wonderful/bin/wf-env.fish
to your Fish configuration. - For zsh, add
alias wf-env='source /opt/wonderful/bin/wf-env'
to your~/.zprofile
.
If you want to access toolchain components (like ia16-elf-gcc
or arm-none-eabi-objdump
) directly, you may wish to add the -a
argument.
Learning more
Detailed (to the best of the toolchain's ability) information about each target and feature is available throughout the wiki. You may also wish to consult other community members. Have fun and remember not to take this hobby too seriously!