From 6c6a9968ff8fa3d02ebc3c06c141497af389810a Mon Sep 17 00:00:00 2001
From: myk002 <myk002@yahoo.com>
Date: Wed, 3 Feb 2021 13:51:02 -0800
Subject: [PATCH] hauling aliases can take from multile stockpiles

---
 data/quickfort/aliases-common.txt     |  4 +++-
 docs/guides/quickfort-alias-guide.rst | 28 ++++++++++++++++++++-------
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/data/quickfort/aliases-common.txt b/data/quickfort/aliases-common.txt
index 25b259894..14661d82c 100644
--- a/data/quickfort/aliases-common.txt
+++ b/data/quickfort/aliases-common.txt
@@ -36,7 +36,9 @@ quantum: {linksonly}{nocontainers}{quantum_enable}{givename}
 
 stop_name: {Empty}
 route_enable: {quantum_enable}{enablecorpses}{enablerefuse}
-quantumstop: ^hrn{name}&sn{stop_name}&&xxx{route_enable enter_sp_config={enter_sp_config_hauling}}s{move}p^{move_back}^q
+sp_link: s{move}p{move_back}
+sp_links: {sp_link}
+quantumstop: ^hrn{name}&sn{stop_name}&&xxx{route_enable enter_sp_config={enter_sp_config_hauling}}{sp_links}^^q
 quantumstopfromeast: {quantumstop move={Right} move_back={Left}}
 quantumstopfromsouth: {quantumstop move={Down} move_back={Up}}
 quantumstopfromwest: {quantumstop move={Left} move_back={Right}}
diff --git a/docs/guides/quickfort-alias-guide.rst b/docs/guides/quickfort-alias-guide.rst
index d5726bedc..f6858ee6d 100644
--- a/docs/guides/quickfort-alias-guide.rst
+++ b/docs/guides/quickfort-alias-guide.rst
@@ -346,11 +346,15 @@ These aliases make it easy to create :wiki:`minecart stop-based quantum stockpil
 +----------------------+                  |
 | quantumstopfromwest  |                  |
 +----------------------+------------------+
+| sp_link              | | move           |
+|                      | | move_back      |
++----------------------+------------------+
 | quantumstop          | | name           |
 |                      | | stop_name      |
 |                      | | route_enable   |
 |                      | | move           |
 |                      | | move_back      |
+|                      | | sp_links       |
 +----------------------+------------------+
 
 The idea is to use a minecart on a track stop to dump an infinite number of
@@ -453,17 +457,27 @@ building your aliases on the ``*prefix`` aliases described later in this
 guide.
 
 Finally, the ``quantumstop`` alias is a more general version of the
-``quantumstopfrom*`` aliases. The ``quantumstopfrom*`` aliases assume that the
-feeder stockpile is orthogonally adjacent to your track stop (which is how
-most people set them up). If your feeder stockpile is somewhere further away,
-you can use the ``quantumstop`` alias directly. In addition to the
-``quantumstopfrom*`` sub-aliases, you can also define the ``move`` and
-``move_back`` sub-aliases, which let you specify the cursor keys required to
-move from the track stop to the feeder stockpile and back again, respectively::
+``quantumstopfrom*`` aliases. The ``quantumstopfrom*`` aliases assume that a
+single feeder stockpile is orthogonally adjacent to your track stop (which is
+how most people set them up). If your feeder stockpile is somewhere further
+away, or you have multiple feeder stockpiles to link, you can use the
+``quantumstop`` alias directly. In addition to the sub-aliases used in the
+``quantumstopfrom*`` alias, you can define the ``move`` and ``move_back``
+sub-aliases, which let you specify the cursor keys required to move from the
+track stop to the (single) feeder stockpile and back again, respectively::
 
     #query
     {quantumstop move="{Right 2}{Up}" move_back="{Down}{Left 2}"}
 
+If you have multiple stockpiles to link, define the ``sp_links`` sub-alias,
+which can chain several ``sp_link`` aliases together, each with their own
+movement configuration::
+
+    #query
+    {quantumstop sp_links="{sp_link move=""{Right}{Up}"" move_back=""{Down}{Left}""}{sp_link move=""{Right}{Down}"" move_back=""{Up}{Left}""}"}
+
+Note the doubled quotes for quoted elements that are within the outer quotes.
+
 Farm plots
 ~~~~~~~~~~