Address PR review comments: paramlinks and shuffle_after_epoch_seed warning.

- Use single backticks for parameter references in shuffle_after_epoch_seed
  docstrings across all 5 reader ops so sphinx_paramlinks creates links.
- Warn when shuffle_after_epoch_seed is provided but shuffle_after_epoch=False
  in FileLoader, FileLabelLoaderBase, and NemoAsrLoader.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: JanuszL

dali/operators/reader/coco_reader_op.cc

@@ -103,11 +103,11 @@ properties.
 
 .. note::
     When using multiple DALI pipelines (e.g., for multi-GPU training), all pipeline
-    instances should use the same ``shuffle_after_epoch_seed`` to ensure a consistent
+    instances should use the same `shuffle_after_epoch_seed` to ensure a consistent
     global shuffle across all shards.
 
 .. note::
-    This argument has no effect unless ``shuffle_after_epoch`` is set to ``True``.)code",
+    This argument has no effect unless `shuffle_after_epoch` is set to ``True``.)code",
       nullptr, false)
   .AddOptionalArg<string>("file_root",
       R"code(Path to a directory that contains the data files.

dali/operators/reader/file_reader_op.cc

@@ -108,11 +108,11 @@ properties.
 
 .. note::
     When using multiple DALI pipelines (e.g., for multi-GPU training), all pipeline
-    instances should use the same ``shuffle_after_epoch_seed`` to ensure a consistent
+    instances should use the same `shuffle_after_epoch_seed` to ensure a consistent
     global shuffle across all shards.
 
 .. note::
-    This argument has no effect unless ``shuffle_after_epoch`` is set to ``True``.)",
+    This argument has no effect unless `shuffle_after_epoch` is set to ``True``.)",
       nullptr, false)
   .AddOptionalArg<vector<string>>("files", R"(A list of file paths to read the data from.
 

dali/operators/reader/fits_reader_op.cc

@@ -81,11 +81,11 @@ properties.
 
 .. note::
     When using multiple DALI pipelines (e.g., for multi-GPU training), all pipeline
-    instances should use the same ``shuffle_after_epoch_seed`` to ensure a consistent
+    instances should use the same `shuffle_after_epoch_seed` to ensure a consistent
     global shuffle across all shards.
 
 .. note::
-    This argument has no effect unless ``shuffle_after_epoch`` is set to ``True``.)",
+    This argument has no effect unless `shuffle_after_epoch` is set to ``True``.)",
                     nullptr, false)
     .AddOptionalArg<vector<string>>("files", R"(A list of file paths to read the data from.
 

dali/operators/reader/loader/file_label_loader.h

@@ -59,8 +59,11 @@ class DLL_PUBLIC FileLabelLoaderBase : public Loader<CPUBackend, ImageLabelWrapp
       current_index_(0),
       current_epoch_(0) {
     int32_t seed_arg = kDaliDataloaderSeed;
-    spec.TryGetArgument(seed_arg, "shuffle_after_epoch_seed");
+    bool has_seed_arg = spec.TryGetArgument(seed_arg, "shuffle_after_epoch_seed");
     shuffle_after_epoch_seed_ = seed_arg;
+    if (has_seed_arg && !shuffle_after_epoch_) {
+      DALI_WARN("`shuffle_after_epoch_seed` has no effect when `shuffle_after_epoch` is False.");
+    }
 
     vector<string> files;
     vector<int> labels;

dali/operators/reader/loader/file_loader.h

@@ -51,8 +51,11 @@ class FileLoader : public Loader<Backend, Target, true> {
         current_index_(0),
         current_epoch_(0) {
     int32_t seed_arg = kDaliDataloaderSeed;
-    spec.TryGetArgument(seed_arg, "shuffle_after_epoch_seed");
+    bool has_seed_arg = spec.TryGetArgument(seed_arg, "shuffle_after_epoch_seed");
     shuffle_after_epoch_seed_ = seed_arg;
+    if (has_seed_arg && !shuffle_after_epoch_) {
+      DALI_WARN("`shuffle_after_epoch_seed` has no effect when `shuffle_after_epoch` is False.");
+    }
     vector<string> files;
 
     file_discovery_opts_.label_from_subdir = false;

dali/operators/reader/loader/nemo_asr_loader.h

@@ -129,6 +129,9 @@ class DLL_PUBLIC NemoAsrLoader : public Loader<CPUBackend, AsrSample, true> {
         decode_scratch_(num_threads_),
         resample_scratch_(num_threads_) {
     DALI_ENFORCE(!manifest_filepaths_.empty(), "``manifest_filepaths`` can not be empty");
+    if (spec.HasArgument("shuffle_after_epoch_seed") && !shuffle_after_epoch_) {
+      DALI_WARN("`shuffle_after_epoch_seed` has no effect when `shuffle_after_epoch` is False.");
+    }
     /*
      * Those options are mutually exclusive as `shuffle_after_epoch` will make every shard looks
      * differently after each epoch so coexistence with `stick_to_shard` doesn't make any sense

dali/operators/reader/nemo_asr_reader_op.cc

@@ -96,11 +96,11 @@ properties.
 
 .. note::
     When using multiple DALI pipelines (e.g., for multi-GPU training), all pipeline
-    instances should use the same ``shuffle_after_epoch_seed`` to ensure a consistent
+    instances should use the same `shuffle_after_epoch_seed` to ensure a consistent
     global shuffle across all shards.
 
 .. note::
-    This argument has no effect unless ``shuffle_after_epoch`` is set to ``True``.)code",
+    This argument has no effect unless `shuffle_after_epoch` is set to ``True``.)code",
     nullptr, false)
   .AddOptionalArg("sample_rate",
     "If specified, the target sample rate, in Hz, to which the audio is resampled.",

dali/operators/reader/numpy_reader_op.cc

@@ -147,11 +147,11 @@ properties.
 
 .. note::
     When using multiple DALI pipelines (e.g., for multi-GPU training), all pipeline
-    instances should use the same ``shuffle_after_epoch_seed`` to ensure a consistent
+    instances should use the same `shuffle_after_epoch_seed` to ensure a consistent
     global shuffle across all shards.
 
 .. note::
-    This argument has no effect unless ``shuffle_after_epoch`` is set to ``True``.)",
+    This argument has no effect unless `shuffle_after_epoch` is set to ``True``.)",
       nullptr, false)
   .AddOptionalArg<vector<string>>("files", R"(A list of file paths to read the data from.