suggestions

Author: IanButterworth

doc/make.jl

@@ -161,7 +161,6 @@ generate_markdown("NEWS")
 Manual = [
     "manual/getting-started.md",
     "manual/installation.md",
-    "manual/memory-management.md",
     "manual/variables.md",
     "manual/integers-and-floating-point-numbers.md",
     "manual/mathematical-operations.md",
@@ -193,6 +192,7 @@ Manual = [
     "manual/code-loading.md",
     "manual/profile.md",
     "manual/stacktraces.md",
+    "manual/memory-management.md",
     "manual/performance-tips.md",
     "manual/workflow-tips.md",
     "manual/style-guide.md",

doc/src/manual/memory-management.md

@@ -35,8 +35,8 @@ If your system has limited or no swap space, you may experience out-of-memory er
 You can provide a hint to Julia about the maximum amount of memory to use:
 
 ```bash
-julia --heap-size-hint=4G  # Limit heap to ~4GB
-julia --heap-size-hint=50% # Use up to 50% of physical memory
+julia --heap-size-hint=4G  # To set the hint to ~4GB
+julia --heap-size-hint=50% # or to 50% of physical memory
 ```
 
 The `--heap-size-hint` option tells the garbage collector to trigger collection more aggressively when approaching the specified limit. This is particularly useful in: