User Tools

Site Tools


getting_started:finish

Post-getting started guide

Updating

As the installer and bootstraps are updated less often than packages themselves (especially outside of Linux), it is recommended to run wf-pacman -Syu after the initial installation.

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 wf- tools easy, you may want to alias wf-env to allow them to be easily added to PATH 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.

Alternatively, you may want to pre-populate the environment variables in your shell on launch:

This is not recommended for Windows/MSYS2 users. Due to DLL resolution issues, this can cause MSYS2-built programs provided by other developers to not work correctly. Caveat emptor.

  • 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.

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!

getting_started/finish.txt · Last modified: by asie