Error when trying to build the docs locally

When trying to build the documentation locally to check how my changes to a tutorial look like, I’m getting a make Error that I cannot really make sense of (most likely due to my lack of understanding of make). Maybe someone has a tip?

Bg info:

  • MNE-Python version: 0.23.dev0
  • operating system: Win10

This is the command that I use to build the doc:
$ PATTERN="plot_time_frequency_erds.py" make html_dev-pattern
but it leads to
make: *** [Makefile:60: html_dev-pattern] Error 1
The only suspicious part of the full output (see below) is this one:

WARNING: document isn’t included in any toctree
C:\Program Files\MNE\mne-python\doc\auto_examples\preprocessing\plot_run_ica.rst: WARNING: document isn’t included in any toctree 

I did not change this file. Does this warning lead to the make Error?
I’m thankful for input.

Full output

BUILD_DEV_HTML=1 sphinx-build -D sphinx_gallery_conf.filename_pattern=plot_time_frequency_erds.py -D sphinx_gallery_conf.run_stale_examples=True -b html -d _build/doctrees -nWT --keep-going . _build/html
Running Sphinx v3.5.2
loading pickled environment… checking for C:\Program Files\MNE\mne-python\doc\references.bib in bibtex cache… up to date
done
[autosummary] generating autosummary for: auto_examples\connectivity\plot_cwt_sensor_connectivity.rst, auto_examples\connectivity\plot_mixed_source_space_connectivity.rst, auto_examples\connectivity\plot_mne_inverse_coherence_epochs.rst, auto_examples\connectivity\plot_mne_inverse_connectivity_spectrum.rst, auto_examples\connectivity\plot_mne_inverse_envelope_correlation.rst, auto_examples\connectivity\plot_mne_inverse_envelope_correlation_volume.rst, auto_examples\connectivity\plot_mne_inverse_label_connectivity.rst, auto_examples\connectivity\plot_mne_inverse_psi_visual.rst, auto_examples\connectivity\plot_sensor_connectivity.rst, auto_examples\datasets\plot_brainstorm_data.rst, …, reading_raw_data.rst, realtime.rst, report.rst, sensor_space.rst, simulation.rst, source_space.rst, statistics.rst, time_frequency.rst, visualization.rst, whats_new.rst
loading intersphinx inventory from https://docs.python.org/3/objects.inv…
loading intersphinx inventory from https://numpy.org/devdocs/objects.inv…
loading intersphinx inventory from https://scipy.github.io/devdocs/objects.inv…
loading intersphinx inventory from https://matplotlib.org/objects.inv…
loading intersphinx inventory from https://scikit-learn.org/stable/objects.inv…
loading intersphinx inventory from https://numba.pydata.org/numba-doc/latest/objects.inv…
loading intersphinx inventory from https://joblib.readthedocs.io/en/latest/objects.inv…
loading intersphinx inventory from http://docs.enthought.com/mayavi/mayavi/objects.inv…
loading intersphinx inventory from https://nipy.org/nibabel/objects.inv…
loading intersphinx inventory from http://nilearn.github.io/objects.inv…
loading intersphinx inventory from https://pysurfer.github.io/objects.inv…
loading intersphinx inventory from https://pandas.pydata.org/pandas-docs/stable/objects.inv…
loading intersphinx inventory from https://seaborn.pydata.org/objects.inv…
loading intersphinx inventory from https://www.statsmodels.org/dev/objects.inv…
loading intersphinx inventory from https://patsy.readthedocs.io/en/latest/objects.inv…
loading intersphinx inventory from https://docs.pyvista.org/objects.inv…
loading intersphinx inventory from https://imageio.readthedocs.io/en/latest/objects.inv…
loading intersphinx inventory from https://mne.tools/mne-realtime/objects.inv…
loading intersphinx inventory from https://pierreablin.github.io/picard/objects.inv…
loading intersphinx inventory from https://qdarkstylesheet.readthedocs.io/en/latest/objects.inv…
generating gallery…
Using Sphinx-Gallery to convert rst text blocks to markdown for .ipynb files.
generating gallery for auto_tutorials\intro… [ 80%] plot_40_sensor_locations.pgenerating gallery for auto_tutorials\intro… [100%] plot_50_configure_mne.py
generating gallery for auto_tutorials\io… [100%] plot_30_reading_fnirs_data.py
generating gallery for auto_tutorials\raw… [100%] plot_40_visualize_raw.py
generating gallery for auto_tutorials\preprocessing… [ 8%] plot_10_preprocessgenerating gallery for auto_tutorials\preprocessing… [ 16%] plot_15_handling_bgenerating gallery for auto_tutorials\preprocessing… [ 25%] plot_20_rejecting_generating gallery for auto_tutorials\preprocessing… [ 33%] plot_30_filtering_generating gallery for auto_tutorials\preprocessing… [ 41%] plot_35_artifact_cgenerating gallery for auto_tutorials\preprocessing… [ 50%] plot_40_artifact_cgenerating gallery for auto_tutorials\preprocessing… [ 58%] plot_45_projectorsgenerating gallery for auto_tutorials\preprocessing… [ 66%] plot_50_artifact_cgenerating gallery for auto_tutorials\preprocessing… [ 75%] plot_55_setting_eegenerating gallery for auto_tutorials\preprocessing… [ 83%] plot_59_head_positgenerating gallery for auto_tutorials\preprocessing… [ 91%] plot_60_maxwell_figenerating gallery for auto_tutorials\preprocessing… [100%] plot_70_fnirs_processing.py
generating gallery for auto_tutorials\epochs… [ 16%] plot_10_epochs_overview.pgenerating gallery for auto_tutorials\epochs… [ 33%] plot_20_visualize_epochs.generating gallery for auto_tutorials\epochs… [ 50%] plot_30_epochs_metadata.pgenerating gallery for auto_tutorials\epochs… [ 66%] plot_40_autogenerate_metagenerating gallery for auto_tutorials\epochs… [ 83%] plot_50_epochs_to_data_frgenerating gallery for auto_tutorials\epochs… [100%] plot_60_make_fixed_length_epochs.py
generating gallery for auto_tutorials\evoked… [ 25%] plot_10_evoked_overview.pgenerating gallery for auto_tutorials\evoked… [ 50%] plot_20_visualize_evoked.generating gallery for auto_tutorials\evoked… [100%] plot_whitened.py
generating gallery for auto_tutorials\time-freq… [ 50%] plot_sensors_time_freqgenerating gallery for auto_tutorials\time-freq… [100%] plot_ssvep.py
generating gallery for auto_tutorials\source-modeling… [ 6%] plot_background_generating gallery for auto_tutorials\source-modeling… [ 13%] plot_background_generating gallery for auto_tutorials\source-modeling… [ 20%] plot_beamformer_generating gallery for auto_tutorials\source-modeling… [ 26%] plot_compute_covgenerating gallery for auto_tutorials\source-modeling… [ 33%] plot_dipole_fit.generating gallery for auto_tutorials\source-modeling… [ 40%] plot_dipole_oriegenerating gallery for auto_tutorials\source-modeling… [ 46%] plot_eeg_mri_coogenerating gallery for auto_tutorials\source-modeling… [ 53%] plot_eeg_no_mri.generating gallery for auto_tutorials\source-modeling… [ 60%] plot_fix_bem_in_generating gallery for auto_tutorials\source-modeling… [ 73%] plot_mne_dspm_sogenerating gallery for auto_tutorials\source-modeling… [ 80%] plot_mne_solutiogenerating gallery for auto_tutorials\source-modeling… [ 86%] plot_object_sourgenerating gallery for auto_tutorials\source-modeling… [ 93%] plot_source_aliggenerating gallery for auto_tutorials\source-modeling… [100%] plot_visualize_stc.py
generating gallery for auto_tutorials\stats-sensor-space… [ 25%] plot_stats_clgenerating gallery for auto_tutorials\stats-sensor-space… [ 50%] plot_stats_clgenerating gallery for auto_tutorials\stats-sensor-space… [ 75%] plot_stats_clgenerating gallery for auto_tutorials\stats-sensor-space… [100%] plot_stats_spatio_temporal_cluster_sensors.py
generating gallery for auto_tutorials\stats-source-space… [ 25%] plot_stats_clgenerating gallery for auto_tutorials\stats-source-space… [ 50%] plot_stats_clgenerating gallery for auto_tutorials\stats-source-space… [ 75%] plot_stats_clgenerating gallery for auto_tutorials\stats-source-space… [100%] plot_stats_cluster_time_frequency_repeated_measures_anova.py
generating gallery for auto_tutorials\machine-learning… [ 50%] plot_receptive_generating gallery for auto_tutorials\machine-learning… [100%] plot_sensors_decoding.py
generating gallery for auto_tutorials\simulation… [ 33%] plot_creating_data_stgenerating gallery for auto_tutorials\simulation… [100%] plot_point_spread.py
generating gallery for auto_tutorials\sample-datasets… [ 20%] plot_brainstorm_generating gallery for auto_tutorials\sample-datasets… [ 40%] plot_brainstorm_generating gallery for auto_tutorials\sample-datasets… [ 60%] plot_brainstorm_generating gallery for auto_tutorials\sample-datasets… [ 80%] plot_phantom_4DBgenerating gallery for auto_tutorials\sample-datasets… [100%] plot_sleep.py
generating gallery for auto_tutorials\discussions… [ 33%] plot_background_filtgenerating gallery for auto_tutorials\discussions… [ 66%] plot_background_ica.generating gallery for auto_tutorials\discussions… [100%] plot_background_statistics.py
generating gallery for auto_tutorials\misc… [ 50%] plot_modifying_data_inplacegenerating gallery for auto_tutorials\misc… [100%] plot_seeg.py
generating gallery for auto_examples\io… [100%] plot_read_noise_covariance_matrix.py
generating gallery for auto_examples\simulation… [ 25%] plot_simulate_evoked_dgenerating gallery for auto_examples\simulation… [ 50%] plot_simulate_raw_datagenerating gallery for auto_examples\simulation… [ 75%] plot_simulated_raw_datgenerating gallery for auto_examples\simulation… [100%] plot_source_simulator.py
generating gallery for auto_examples\preprocessing… [ 7%] plot_define_target_generating gallery for auto_examples\preprocessing… [ 21%] plot_eog_artifact_hgenerating gallery for auto_examples\preprocessing… [ 28%] plot_find_ref_artifgenerating gallery for auto_examples\preprocessing… [ 35%] plot_fnirs_artifactgenerating gallery for auto_examples\preprocessing… [ 42%] plot_ica_comparisongenerating gallery for auto_examples\preprocessing… [ 50%] plot_interpolate_bagenerating gallery for auto_examples\preprocessing… [ 57%] plot_movement_compegenerating gallery for auto_examples\preprocessing… [ 64%] plot_movement_detecgenerating gallery for auto_examples\preprocessing… [ 71%] plot_muscle_detectigenerating gallery for auto_examples\preprocessing… [ 85%] plot_shift_evoked.pgenerating gallery for auto_examples\preprocessing… [ 92%] plot_virtual_evokedgenerating gallery for auto_examples\preprocessing… [100%] plot_xdawn_denoising.py
generating gallery for auto_examples\visualization… [ 16%] plot_channel_epochsgenerating gallery for auto_examples\visualization… [ 22%] plot_eeg_on_scalp.pgenerating gallery for auto_examples\visualization… [ 27%] plot_eeglab_head_spgenerating gallery for auto_examples\visualization… [ 33%] plot_evoked_arrowmagenerating gallery for auto_examples\visualization… [ 38%] plot_evoked_topomapgenerating gallery for auto_examples\visualization… [ 44%] plot_evoked_whitenigenerating gallery for auto_examples\visualization… [ 61%] plot_parcellation.pgenerating gallery for auto_examples\visualization… [ 66%] plot_publication_figenerating gallery for auto_examples\visualization… [ 72%] plot_roi_erpimage_bgenerating gallery for auto_examples\visualization… [ 77%] plot_sensor_noise_lgenerating gallery for auto_examples\visualization… [ 83%] plot_ssp_projs_sensgenerating gallery for auto_examples\visualization… [ 88%] plot_topo_compare_cgenerating gallery for auto_examples\visualization… [ 94%] plot_topo_customizegenerating gallery for auto_examples\visualization… [100%] plot_xhemi.py
generating gallery for auto_examples\time_frequency… [ 10%] plot_compute_csd.pgenerating gallery for auto_examples\time_frequency… [ 20%] plot_compute_sourcgenerating gallery for auto_examples\time_frequency… [ 30%] plot_source_label_generating gallery for auto_examples\time_frequency… [ 40%] plot_source_power_generating gallery for auto_examples\time_frequency… [ 50%] plot_source_power_generating gallery for auto_examples\time_frequency… [ 60%] plot_source_space_generating gallery for auto_examples\time_frequency… [ 70%] plot_temporal_whitgenerating gallery for auto_examples\time_frequency… [ 80%] plot_time_frequencgenerating gallery for auto_examples\time_frequency… [ 90%] plot_time_frequencgenerating gallery for auto_examples\time_frequency… [100%] plot_time_frequency_simulated.py
generating gallery for auto_examples\stats… [ 20%] plot_cluster_stats_evoked.pgenerating gallery for auto_examples\stats… [ 60%] plot_linear_regression_raw.generating gallery for auto_examples\stats… [ 80%] plot_sensor_permutation_tesgenerating gallery for auto_examples\stats… [100%] plot_sensor_regression.py
generating gallery for auto_examples\decoding… [ 25%] plot_decoding_csp_timefrgenerating gallery for auto_examples\decoding… [ 33%] plot_decoding_spatio_temgenerating gallery for auto_examples\decoding… [ 41%] plot_decoding_spoc_CMC.pgenerating gallery for auto_examples\decoding… [ 50%] plot_decoding_time_genergenerating gallery for auto_examples\decoding… [ 58%] plot_decoding_unsupervisgenerating gallery for auto_examples\decoding… [ 66%] plot_decoding_xdawn_eeg.generating gallery for auto_examples\decoding… [ 83%] plot_linear_model_pattergenerating gallery for auto_examples\decoding… [ 91%] plot_receptive_field_mtrgenerating gallery for auto_examples\decoding… [100%] plot_ssd_spatial_filters.py
generating gallery for auto_examples\connectivity… [ 11%] plot_cwt_sensor_conngenerating gallery for auto_examples\connectivity… [ 22%] plot_mixed_source_spgenerating gallery for auto_examples\connectivity… [ 33%] plot_mne_inverse_cohgenerating gallery for auto_examples\connectivity… [ 44%] plot_mne_inverse_congenerating gallery for auto_examples\connectivity… [ 55%] plot_mne_inverse_envgenerating gallery for auto_examples\connectivity… [ 66%] plot_mne_inverse_envgenerating gallery for auto_examples\connectivity… [ 77%] plot_mne_inverse_labgenerating gallery for auto_examples\connectivity… [ 88%] plot_mne_inverse_psigenerating gallery for auto_examples\connectivity… [100%] plot_sensor_connectivity.py
generating gallery for auto_examples\forward… [ 33%] plot_forward_sensitivity_generating gallery for auto_examples\forward… [ 66%] plot_left_cerebellum_volugenerating gallery for auto_examples\forward… [100%] plot_source_space_morphing.py
generating gallery for auto_examples\inverse… [ 3%] plot_compute_mne_inverse_generating gallery for auto_examples\inverse… [ 6%] plot_compute_mne_inverse_generating gallery for auto_examples\inverse… [ 10%] plot_compute_mne_inverse_generating gallery for auto_examples\inverse… [ 13%] plot_covariance_whiteninggenerating gallery for auto_examples\inverse… [ 17%] plot_custom_inverse_solvegenerating gallery for auto_examples\inverse… [ 24%] plot_evoked_ers_source_pogenerating gallery for auto_examples\inverse… [ 31%] plot_label_activation_frogenerating gallery for auto_examples\inverse… [ 37%] plot_label_source_activatgenerating gallery for auto_examples\inverse… [ 41%] plot_mixed_norm_inverse.pgenerating gallery for auto_examples\inverse… [ 44%] plot_mixed_source_space_igenerating gallery for auto_examples\inverse… [ 58%] plot_multidict_reweightedgenerating gallery for auto_examples\inverse… [ 62%] plot_psf_ctf_label_leakaggenerating gallery for auto_examples\inverse… [ 68%] plot_psf_ctf_vertices_lcmgenerating gallery for auto_examples\inverse… [ 82%] plot_resolution_metrics.pgenerating gallery for auto_examples\inverse… [ 86%] plot_resolution_metrics_egenerating gallery for auto_examples\inverse… [ 96%] plot_time_frequency_mixedgenerating gallery for auto_examples\inverse… [100%] plot_vector_mne_solution.py
generating gallery for auto_examples\datasets… [100%] spm_faces_dataset.py
computation time summary:
- …\examples\time_frequency\plot_time_frequency_erds.py: 23.43 sec 0.0 MB
generating MNE command help … [100%] mne_what.py
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 767 source files that are out of date
updating environment: 0 added, 118 changed, 0 removed
reading sources… [ 0%] auto_examples/connectivity/plot_mixed_source_space_conreading sources… [ 1%] auto_examples/connectivity/plot_mne_inverse_coherence_reading sources… [ 2%] auto_examples/connectivity/plot_mne_inverse_connectivireading sources… [ 3%] auto_examples/connectivity/plot_mne_inverse_envelope_creading sources… [ 4%] auto_examples/connectivity/plot_mne_inverse_envelope_creading sources… [ 5%] auto_examples/connectivity/plot_mne_inverse_label_connreading sources… [ 59%] generated/mne.preprocessing.nirs.source_detector_distareading sources… [ 60%] generated/mne.preprocessing.nirs.temporal_derivative_dreading sources… [100%] whats_new
looking for now-outdated files… none found
pickling environment… done
checking consistency… C:\Program Files\MNE\mne-python\doc\auto_examples\inverse\plot_tf_dics.rst: WARNING: document isn’t included in any toctree
C:\Program Files\MNE\mne-python\doc\auto_examples\preprocessing\plot_run_ica.rst: WARNING: document isn’t included in any toctree
done
preparing documents… done
writing output… [ 0%] auto_examples/connectivity/plot_mixed_source_space_connwriting output… [ 0%] auto_examples/connectivity/plot_mne_inverse_coherence_ewriting output… [ 0%] auto_examples/connectivity/plot_mne_inverse_connectivitwriting output… [ 0%] auto_examples/connectivity/plot_mne_inverse_envelope_cowriting output… [ 0%] auto_examples/connectivity/plot_mne_inverse_envelope_cowriting output… [ 0%] auto_examples/connectivity/plot_mne_inverse_label_connewriting output… [ 2%] auto_examples/decoding/plot_decoding_spatio_temporal_sowriting output… [ 2%] auto_examples/decoding/plot_decoding_time_generalizatiowriting output… [ 2%] auto_examples/decoding/plot_decoding_unsupervised_spatiwriting output… [ 3%] auto_examples/forward/plot_left_cerebellum_volume_sourcwriting output… [ 4%] auto_examples/inverse/plot_compute_mne_inverse_epochs_iwriting output… [ 4%] auto_examples/inverse/plot_compute_mne_inverse_raw_in_lwriting output… [ 7%] auto_examples/inverse/plot_time_frequency_mixed_norm_inwriting output… [ 9%] auto_examples/preprocessing/plot_interpolate_bad_channewriting output… [ 10%] auto_examples/simulation/plot_simulated_raw_data_using_writing output… [ 11%] auto_examples/time_frequency/plot_compute_source_psd_epwriting output… [ 11%] auto_examples/time_frequency/plot_source_label_time_frewriting output… [ 11%] auto_examples/time_frequency/plot_source_power_spectrumwriting output… [ 12%] auto_examples/time_frequency/plot_source_space_time_frewriting output… [ 12%] auto_examples/time_frequency/plot_time_frequency_globalwriting output… [ 12%] auto_examples/time_frequency/plot_time_frequency_simulawriting output… [ 14%] auto_examples/visualization/plot_ssp_projs_sensitivity_writing output… [ 14%] auto_examples/visualization/plot_topo_compare_conditionwriting output… [ 18%] auto_tutorials/preprocessing/plot_10_preprocessing_overwriting output… [ 19%] auto_tutorials/preprocessing/plot_15_handling_bad_channwriting output… [ 19%] auto_tutorials/preprocessing/plot_30_filtering_resampliwriting output… [ 19%] auto_tutorials/preprocessing/plot_35_artifact_correctiowriting output… [ 19%] auto_tutorials/preprocessing/plot_40_artifact_correctiowriting output… [ 19%] auto_tutorials/preprocessing/plot_45_projectors_backgrowriting output… [ 19%] auto_tutorials/preprocessing/plot_50_artifact_correctiowriting output… [ 19%] auto_tutorials/preprocessing/plot_55_setting_eeg_referewriting output… [ 20%] auto_tutorials/preprocessing/plot_60_maxwell_filtering_writing output… [ 21%] auto_tutorials/sample-datasets/plot_brainstorm_phantom_writing output… [ 21%] auto_tutorials/sample-datasets/plot_brainstorm_phantom_writing output… [ 22%] auto_tutorials/source-modeling/plot_background_freesurfwriting output… [ 22%] auto_tutorials/source-modeling/plot_background_freesurfwriting output… [ 23%] auto_tutorials/source-modeling/plot_mne_dspm_source_locwriting output… [ 23%] auto_tutorials/source-modeling/plot_object_source_estimwriting output… [ 23%] auto_tutorials/stats-sensor-space/plot_stats_cluster_1swriting output… [ 24%] auto_tutorials/stats-sensor-space/plot_stats_cluster_erwriting output… [ 24%] auto_tutorials/stats-sensor-space/plot_stats_cluster_tiwriting output… [ 24%] auto_tutorials/stats-sensor-space/plot_stats_spatio_temwriting output… [ 24%] auto_tutorials/stats-source-space/plot_stats_cluster_spwriting output… [ 24%] auto_tutorials/stats-source-space/plot_stats_cluster_spwriting output… [ 24%] auto_tutorials/stats-source-space/plot_stats_cluster_spwriting output… [ 25%] auto_tutorials/stats-source-space/plot_stats_cluster_tiwriting output… [ 41%] generated/mne.datasets.brainstorm.bst_auditory.data_patwriting output… [ 44%] generated/mne.datasets.sleep_physionet.temazepam.fetch_writing output… [ 61%] generated/mne.minimum_norm.make_inverse_resolution_matrwriting output… [ 64%] generated/mne.preprocessing.compute_current_source_denswriting output… [ 67%] generated/mne.preprocessing.nirs.source_detector_distanwriting output… [ 67%] generated/mne.preprocessing.nirs.temporal_derivative_diwriting output… [ 67%] generated/mne.preprocessing.oversampled_temporal_projecwriting output… [100%] whats_new
generating indices… genindex py-modindex done
writing additional pages… search done
copying images… [ 0%] auto_examples/io/images/thumb/sphx_glr_plot_elekta_epoccopying images… [ 0%] auto_examples/io/images/thumb/sphx_glr_plot_read_neo_focopying images… [ 1%] auto_examples/io/images/thumb/sphx_glr_plot_read_noise_copying images… [ 1%]
…
auto_examples/inverse/images/thumb/sphx_glr_plot_tf_diccopying images… [100%] overview…/_static/HeadCS.png
copying downloadable files… [ 0%] auto_examples/connectivity/plot_cwt_sensor_copying downloadable files… [ 0%] auto_examples/connectivity/plot_cwt_sensor_copying downloadable files… [ 0%]
auto_examples/connectivity/plot_sensor_conncopying downloadable files… [ 1%]
…
auto_tutorials/source-modeling/plot_visualicopying downloadable files… [100%] auto_tutorials/source-modeling/plot_visualize_stc.ipynb
copying static files… done
copying extra files… done
dumping search index in English (code: en)… done
dumping object inventory… done
build finished with problems, 2 warnings.

Sphinx-Gallery successfully executed 1 out of 1 file subselected by:

gallery_conf["filename_pattern"] = 'plot_time_frequency_erds.py'
gallery_conf["ignore_pattern"]   = '__init__\\.py'

after excluding 0 files that had previously been run (based on MD5).

embedding documentation hyperlinks…
embedding documentation hyperlinks for auto_tutorials… [ 2%] plot_background_embedding documentation hyperlinks for auto_tutorials… [ 3%] plot_background_embedding documentation hyperlinks for auto_tutorials… [ 5%] plot_background_embedding documentation hyperlinks for auto_tutorials… [ 6%] plot_10_epochs_oembedding documentation hyperlinks for auto_tutorials… [ 7%] plot_20_visualizembedding documentation hyperlinks for auto_tutorials… [ 8%] plot_30_epochs_membedding documentation hyperlinks for auto_tutorials… [ 10%]
…
plot_sensors_timembedding documentation hyperlinks for auto_tutorials… [100%] plot_ssvep.html
embedding documentation hyperlinks for auto_examples… [ 1%] plot_cwt_sensor_cembedding documentation hyperlinks for auto_examples… [ 2%] plot_mixed_sourceembedding documentation hyperlinks for auto_examples… [ 3%] plot_mne_inverse_embedding documentation hyperlinks for auto_examples… [ 4%] plot_mne_inverse_embedding documentation hyperlinks for auto_examples… [ 5%] plot_mne_inverse_embedding documentation hyperlinks for auto_examples… [ 6%] plot_mne_inverse_embedding documentation hyperlinks for auto_examples… [ 6%] plot_mne_inverse_embedding documentation hyperlinks for auto_examples… [ 7%] plot_mne_inverse_embedding documentation hyperlinks for auto_examples… [ 8%] plot_sensor_conneembedding documentation hyperlinks for auto_examples… [ 9%] plot_brainstorm_dembedding documentation hyperlinks for auto_examples… [ 10%] plot_hf_sef_data.embedding documentation hyperlinks for auto_examples… [ 11%] plot_limo_data.htembedding documentation hyperlinks for auto_examples… [ 12%] plot_opm_data.htmembedding documentation hyperlinks for auto_examples… [ 12%] spm_faces_datasetembedding documentation hyperlinks for auto_examples… [ 14%] plot_decoding_cspembedding documentation hyperlinks for auto_examples… [ 15%] plot_decoding_cspembedding documentation hyperlinks for auto_examples… [ 16%] plot_decoding_spaembedding documentation hyperlinks for auto_examples… [ 17%] plot_decoding_spoembedding documentation hyperlinks for auto_examples… [ 18%] plot_decoding_timembedding documentation hyperlinks for auto_examples… [ 18%] plot_decoding_unsembedding documentation hyperlinks for auto_examples… [ 19%] plot_decoding_xdaembedding documentation hyperlinks for auto_examples… [ 20%] plot_ems_filterinembedding documentation hyperlinks for auto_examples… [ 21%] plot_linear_modelembedding documentation hyperlinks for auto_examples… [ 22%] plot_receptive_fiembedding documentation hyperlinks for auto_examples… [ 23%] plot_ssd_spatial_embedding documentation hyperlinks for auto_examples… [ 24%] plot_forward_sensembedding documentation hyperlinks for auto_examples… [ 25%] plot_left_cerebelembedding documentation hyperlinks for auto_examples… [ 25%] plot_source_spaceembedding documentation hyperlinks for auto_examples… [ 26%] plot_compute_mne_embedding documentation hyperlinks for auto_examples… [ 27%] plot_compute_mne_embedding documentation hyperlinks for auto_examples… [ 28%] plot_compute_mne_embedding documentation hyperlinks for auto_examples… [ 29%] plot_covariance_wembedding documentation hyperlinks for auto_examples… [ 30%] plot_custom_inverembedding documentation hyperlinks for auto_examples… [ 31%] plot_dics_source_embedding documentation hyperlinks for auto_examples… [ 31%] plot_evoked_ers_sembedding documentation hyperlinks for auto_examples… [ 32%] plot_gamma_map_inembedding documentation hyperlinks for auto_examples… [ 33%] plot_label_activaembedding documentation hyperlinks for auto_examples… [ 34%] plot_label_from_sembedding documentation hyperlinks for auto_examples… [ 35%] plot_label_sourceembedding documentation hyperlinks for auto_examples… [ 36%] plot_mixed_norm_iembedding documentation hyperlinks for auto_examples… [ 37%] plot_mixed_sourceembedding documentation hyperlinks for auto_examples… [ 37%] plot_mne_cov_poweembedding documentation hyperlinks for auto_examples… [ 38%] plot_morph_surfacembedding documentation hyperlinks for auto_examples… [ 39%] plot_morph_volumeembedding documentation hyperlinks for auto_examples… [ 40%] plot_multidict_reembedding documentation hyperlinks for auto_examples… [ 41%] plot_psf_ctf_labeembedding documentation hyperlinks for auto_examples… [ 42%] plot_psf_ctf_vertembedding documentation hyperlinks for auto_examples… [ 43%] plot_psf_ctf_vertembedding documentation hyperlinks for auto_examples… [ 43%] plot_rap_music.htembedding documentation hyperlinks for auto_examples… [ 44%] plot_read_inverseembedding documentation hyperlinks for auto_examples… [ 45%] plot_read_stc.htmembedding documentation hyperlinks for auto_examples… [ 46%] plot_resolution_membedding documentation hyperlinks for auto_examples… [ 47%] plot_resolution_membedding documentation hyperlinks for auto_examples… [ 48%] plot_snr_estimateembedding documentation hyperlinks for auto_examples… [ 49%] plot_source_spaceembedding documentation hyperlinks for auto_examples… [ 50%] plot_time_frequenembedding documentation hyperlinks for auto_examples… [ 51%] plot_vector_mne_sembedding documentation hyperlinks for auto_examples… [ 52%] plot_elekta_epochembedding documentation hyperlinks for auto_examples… [ 53%] plot_read_neo_forembedding documentation hyperlinks for auto_examples… [ 54%] plot_read_noise_cembedding documentation hyperlinks for auto_examples… [ 55%] plot_define_targeembedding documentation hyperlinks for auto_examples… [ 56%] plot_eog_artifactembedding documentation hyperlinks for auto_examples… [ 57%] plot_find_ref_artembedding documentation hyperlinks for auto_examples… [ 58%] plot_fnirs_artifaembedding documentation hyperlinks for auto_examples… [ 59%] plot_ica_comparisembedding documentation hyperlinks for auto_examples… [ 60%] plot_interpolate_embedding documentation hyperlinks for auto_examples… [ 61%] plot_movement_comembedding documentation hyperlinks for auto_examples… [ 62%] plot_movement_detembedding documentation hyperlinks for auto_examples… [ 62%] plot_muscle_detecembedding documentation hyperlinks for auto_examples… [ 65%] plot_shift_evokedembedding documentation hyperlinks for auto_examples… [ 66%] plot_virtual_evokembedding documentation hyperlinks for auto_examples… [ 67%] plot_xdawn_denoisembedding documentation hyperlinks for auto_examples… [ 68%] plot_simulated_raembedding documentation hyperlinks for auto_examples… [ 68%] plot_simulate_evoembedding documentation hyperlinks for auto_examples… [ 69%] plot_simulate_rawembedding documentation hyperlinks for auto_examples… [ 70%] plot_source_simulembedding documentation hyperlinks for auto_examples… [ 71%] plot_cluster_statembedding documentation hyperlinks for auto_examples… [ 72%] plot_fdr_stats_evembedding documentation hyperlinks for auto_examples… [ 73%] plot_linear_regreembedding documentation hyperlinks for auto_examples… [ 74%] plot_sensor_permuembedding documentation hyperlinks for auto_examples… [ 75%] plot_sensor_regreembedding documentation hyperlinks for auto_examples… [ 75%] plot_compute_csd.embedding documentation hyperlinks for auto_examples… [ 76%] plot_compute_sourembedding documentation hyperlinks for auto_examples… [ 77%] plot_source_labelembedding documentation hyperlinks for auto_examples… [ 78%] plot_source_powerembedding documentation hyperlinks for auto_examples… [ 79%] plot_source_powerembedding documentation hyperlinks for auto_examples… [ 80%] plot_source_spaceembedding documentation hyperlinks for auto_examples… [ 81%] plot_temporal_whiembedding documentation hyperlinks for auto_examples… [ 81%] plot_time_frequenembedding documentation hyperlinks for auto_examples… [ 82%] plot_time_frequenembedding documentation hyperlinks for auto_examples… [ 83%] plot_time_frequenembedding documentation hyperlinks for auto_examples… [ 84%] sg_execution_timeembedding documentation hyperlinks for auto_examples… [ 86%] plot_3d_to_2d.htmembedding documentation hyperlinks for auto_examples… [ 87%] plot_channel_epocembedding documentation hyperlinks for auto_examples… [ 87%] plot_eeglab_head_embedding documentation hyperlinks for auto_examples… [ 88%] plot_eeg_on_scalpembedding documentation hyperlinks for auto_examples… [ 89%] plot_evoked_arrowembedding documentation hyperlinks for auto_examples… [ 90%] plot_evoked_topomembedding documentation hyperlinks for auto_examples… [ 91%] plot_evoked_whiteembedding documentation hyperlinks for auto_examples… [ 92%] plot_meg_sensors.embedding documentation hyperlinks for auto_examples… [ 93%] plot_mne_helmet.hembedding documentation hyperlinks for auto_examples… [ 93%] plot_parcellationembedding documentation hyperlinks for auto_examples… [ 94%] plot_publication_embedding documentation hyperlinks for auto_examples… [ 95%] plot_roi_erpimageembedding documentation hyperlinks for auto_examples… [ 96%] plot_sensor_noiseembedding documentation hyperlinks for auto_examples… [ 97%] plot_ssp_projs_seembedding documentation hyperlinks for auto_examples… [ 98%] plot_topo_compareembedding documentation hyperlinks for auto_examples… [ 99%] plot_topo_customiembedding documentation hyperlinks for auto_examples… [100%] plot_xhemi.html
make: *** [Makefile:60: html_dev-pattern] Error 1

Yes, we fail on warnings. Most of your docs should still have been built, so running make show should open it in a browser.

Have you tried running make clean to get rid of any leftover files from previous build attempts>?

1 Like

@richard thanks a bunch!
I didn’t know/try that make show works even after an error. That worked - and after make clear also the warning was resolved. Perfect!

Quick follow-up to explain the error:

As @richard already said, our doc build treats warnings like errors when deciding whether to say “build succeeded” or “build failed”. This helps us catch minor mistakes that surface as warnings (like cross-references that don’t properly resolve).

This particular warning (document isn’t included in any toctree) relates to sphinx’s strong preference that every .rst file in the build folder should be part of the “TOC tree” (table of contents tree, i.e., the nested list of pages that will determine the linear order of docs pages, which in turn determines where the next/previous page buttons link to on any given page). Any page that you want sphinx to build, but which you don’t want to be part of that linear ordering of pages, must be labelled as :orphan: on its first line.

The warning happened to you because last time you built the docs locally, examples/preprocessing/plot_run_ica.py existed, so sphinx made doc/auto_examples/preprocessing/plot_run_ica.rst from it. Meanwhile the .py file source of that example has been removed (its content was merged into the ICA tutorial) and you updated your local clone to reflect this (and other) recent changes. Hence that file doesn’t end up in the TOCtree when the examples pages get generated. But since you hadn’t run make clean, the old .rst file was still around, so when converting all the .rsts to .html pages, Sphinx notices, and complains.

1 Like