Differences

This shows you the differences between two versions of the page.

--- getting_started:finish [2025/08/30 15:00] – created asie
+++ getting_started:finish [2025/11/26 22:17] (current) – [Configuring environment variables] asie
@@ Line 1: / Line 1: @@
 ====== 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 =====
@@ Line 13: / Line 17: @@
 ===== Configuring environment variables =====
-To make accessing Wonderful easy, you may want to pre-populate the environment variables in your shell on launch:
+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:
+<WRAP center round important 100%>
+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.
+</WRAP>
   * For **bash**, add ''%%source /opt/wonderful/bin/wf-env%%'' to your ''%%~/.profile%%''.
@@ Line 19: / Line 33: @@
   * 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:
+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.
-  * For **bash**, add ''%%alias wf-env='source /opt/wonderful/bin/wf-env'%%'' to your ''%%~/.profile%%''.
+===== Learning more =====
-  * 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.
+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!