Some docs updates

crates/eww/src/config/inbuilt.rs

@@ -81,17 +81,17 @@ macro_rules! define_magic_constants {
     }
 }
 define_magic_constants! { eww_paths,
-    // @desc EWW_CONFIG_DIR - Path to the eww configuration of the current process
+    // @desc EWW_CONFIG_DIR (Magic constant) - Path to the eww configuration of the current process
     "EWW_CONFIG_DIR" => DynVal::from_string(eww_paths.get_config_dir().to_string_lossy().into_owned()),
 
-    // @desc EWW_CMD - eww command running in the current configuration, useful in event handlers. I.e.: `:onclick "${EWW_CMD} update foo=bar"`
+    // @desc EWW_CMD (Magic constant) - eww command running in the current configuration, useful in event handlers. I.e.: `:onclick "${EWW_CMD} update foo=bar"`
     "EWW_CMD" => DynVal::from_string(
         format!("\"{}\" --config \"{}\"",
             std::env::current_exe().map(|x| x.to_string_lossy().into_owned()).unwrap_or_else(|_| "eww".to_string()),
             eww_paths.get_config_dir().to_string_lossy().into_owned()
         )
     ),
-    // @desc EWW_EXECUTABLE - Full path of the eww executable
+    // @desc EWW_EXECUTABLE (Magic constant) - Full path of the eww executable
     "EWW_EXECUTABLE" => DynVal::from_string(
         std::env::current_exe().map(|x| x.to_string_lossy().into_owned()).unwrap_or_else(|_| "eww".to_string()),
     ),

crates/eww/src/server.rs

@@ -33,7 +33,6 @@ pub fn initialize_server<B: DisplayBackend>(
     log::info!("Loading paths: {}", &paths);
 
     let read_config = config::read_from_eww_paths(&paths);
-
     let eww_config = match read_config {
         Ok(config) => config,
         Err(err) => {
@@ -42,6 +41,10 @@ pub fn initialize_server<B: DisplayBackend>(
         }
     };
 
+    for (name, definition) in config::inbuilt::get_magic_constants(&paths) {
+        std::env::set_var(name.0, definition.initial_value.0);
+    }
+
     cleanup_log_dir(paths.get_log_dir())?;
 
     if should_daemonize {

crates/eww/src/widgets/widget_definitions.rs

@@ -312,7 +312,8 @@ fn build_gtk_combo_box_text(bargs: &mut BuilderArgs) -> Result<gtk::ComboBoxText
 
 const WIDGET_NAME_EXPANDER: &str = "expander";
 /// @widget expander
-/// @desc A widget that can expand and collapse, showing/hiding it's children.
+/// @desc A widget that can expand and collapse, showing/hiding it's children. Should contain
+/// exactly one child.
 fn build_gtk_expander(bargs: &mut BuilderArgs) -> Result<gtk::Expander> {
     let gtk_widget = gtk::Expander::new(None);
 

docs/src/expression_language.md

@@ -40,6 +40,7 @@ Supported currently are the following features:
 - some function calls:
     - `round(number, decimal_digits)`: Round a number to the given amount of decimals
     - `sin(number)`, `cos(number)`, `tan(number)`, `cot(number)`: Calculate the trigonometric value of a given number in **radians**
+    - `min(a, b)`, `max(a, b)`: Get the smaller or bigger number out of two given numbers
     - `degtorad(number)`: Converts a number from degrees to radians
     - `radtodeg(number)`: Converts a number from radians to degrees
     - `replace(string, regex, replacement)`: Replace matches of a given regex in a string

docs/src/magic-vars.md

@@ -4,3 +4,6 @@ These are variables that are always there, without you having to import them.
 
 The delay between all the updating variables except `EWW_TIME` is 2s, for `EWW_TIME` it is 1s.
 
+There are also `magic constants`, marked with `(Magic constant)` after the variable's name. As the name implies, they do not change.
+You can also get them from within your scripts since they are automatically exported as environmental variables!
+