====== 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:index|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 [[:start|the wiki]]. You may also wish to consult [[:community|other community members]]. Have fun and remember not to take this hobby too seriously!