From e1ba9b2e46f0d67b5b3483e28750e4a3c86d1c39 Mon Sep 17 00:00:00 2001
From: Richard Walters <rwalters@digitalstirling.com>
Date: Tue, 3 Jul 2018 00:22:30 -0700
Subject: Document parts of the path normalization process

Add comments that link parts of the code back
to lines of the pseudocode in the RFC,
to make the code easier to understand.
---
 src/Uri.cpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/Uri.cpp b/src/Uri.cpp
index 721442e..30b58e5 100644
--- a/src/Uri.cpp
+++ b/src/Uri.cpp
@@ -810,6 +810,8 @@ namespace Uri {
                         target.impl_->query = impl_->query;
                     }
                 } else {
+                    // RFC describes this as:
+                    // "if (R.path starts-with "/") then"
                     if (
                         !relativeReference.impl_->path.empty()
                         && (relativeReference.impl_->path[0] == "")
@@ -817,6 +819,8 @@ namespace Uri {
                         target.impl_->path = relativeReference.impl_->path;
                         target.NormalizePath();
                     } else {
+                        // RFC describes this as:
+                        // "T.path = merge(Base.path, R.path);"
                         target.impl_->path = impl_->path;
                         if (target.impl_->path.size() > 1) {
                             target.impl_->path.pop_back();
-- 
cgit v1.2.3