Review comments

Author: spoorcc

doc/_ext/scenario_directive.py

@@ -43,8 +43,11 @@
 from docutils import nodes
 from docutils.parsers.rst import Directive, directives
 from docutils.statemachine import StringList
+from sphinx.util import logging
 from sphinx.util.nodes import make_refnode
 
+logger = logging.getLogger(__name__)
+
 # ---------------------------------------------------------------------------
 # Custom node types
 # ---------------------------------------------------------------------------
@@ -309,6 +312,19 @@ def run(self) -> List[nodes.Node]:
         available = _all_scenarios(feature_abs)
         scenario_titles = self._requested_scenarios(available)
 
+        if "scenario" in self.options:
+            available_titles = {title for _, title in available}
+            requested = [
+                t.strip() for t in self.options["scenario"].splitlines() if t.strip()
+            ]
+            missing = [t for t in requested if t not in available_titles]
+            if missing:
+                raise self.error(
+                    f"Scenario(s) not found in {feature_file}: {', '.join(missing)}"
+                )
+            if not scenario_titles:
+                raise self.error(f"No scenarios matched in {feature_file}.")
+
         if self._is_pdf() and "inline" not in self.options:
             return self._render_pdf(feature_file, feature_abs, scenario_titles)
 
@@ -454,6 +470,12 @@ def resolve_scenario_appendix_refs(
             else:
                 para += nodes.Text(" in the Appendix.")
         else:
+            logger.warning(
+                "PDF build will omit deferred scenario examples because no "
+                "'.. scenario-appendix::' directive was found in the document tree; "
+                "add it to a page (e.g. an appendix) to include deferred examples.",
+                location=ref_node,
+            )
             para += nodes.Text(f"See \u201c{title}\u201d {examples} in the Appendix.")
 
         ref_node.replace_self(para)

features/fetch-git-repo-with-submodule.feature

@@ -1,4 +1,4 @@
-@update
+@update @report
 Feature: Fetch projects with nested VCS dependencies
 
     Some projects include nested version control dependencies

features/guard-against-overwriting-svn.feature

@@ -1,4 +1,4 @@
-@update
+@remote-svn @update
 Feature: Guard against overwriting in svn
 
     Accidentally overwriting local changes could lead to introducing regressions.