[ https://issues.apache.org/jira/browse/CLIMATE-760?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15146093#comment-15146093 ]
ASF GitHub Bot commented on CLIMATE-760: ---------------------------------------- GitHub user lewismc opened a pull request: https://github.com/apache/climate/pull/310 CLIMATE-760 Address documentation warnings Hi @huikyole , can you please explain what the correct content should be for the following documentation snippet from ocw/data_source/local.py ``` def load_GPM_IMERG_files(file_path=None, filename_pattern=None, filelist=None, variable_name='precipitationCal', name='GPM_IMERG'): ... :param filelist: A list of filenames :type filelist: :list:`string` ``` Can you explain what you would usually feed into the filelist parameter? I am getting a warning saying "ERROR: Unknown interpreted text role "list"." So the specific syntax which is incorrect is ``` :type filelist: :list:`string` ``` Thanks for any help. You can merge this pull request into a Git repository by running: $ git pull https://github.com/lewismc/climate CLIMATE-760 Alternatively you can review and apply these changes as the patch at: https://github.com/apache/climate/pull/310.patch To close this pull request, make a commit to your master/trunk branch with (at least) the following in the commit message: This closes #310 ---- commit 3c00361edba4b04455e15fa6f71b65164507833e Author: Lewis John McGibbney <lewis.j.mcgibb...@jpl.nasa.gov> Date: 2016-02-13T17:52:52Z CLIMATE-760 Address documentation warnings ---- > Address documentation warnings > ------------------------------ > > Key: CLIMATE-760 > URL: https://issues.apache.org/jira/browse/CLIMATE-760 > Project: Apache Open Climate Workbench > Issue Type: Improvement > Components: documentation > Reporter: Lewis John McGibbney > Assignee: Paul Ramirez > Priority: Trivial > Fix For: 1.1 > > > When building the documentation we get the following > {code} > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_GPM_IMERG_files:13: ERROR: Unexpected indentation. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_GPM_IMERG_files:1: ERROR: Unknown interpreted text role "list". > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_GPM_IMERG_files:1: ERROR: Unknown interpreted text role "list". > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_GPM_IMERG_files:14: WARNING: Block quote ends without a blank > line; unexpected unindent. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_NLDAS_forcingA_files:14: ERROR: Unexpected indentation. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_NLDAS_forcingA_files:1: ERROR: Unknown interpreted text role > "list". > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_NLDAS_forcingA_files:1: ERROR: Unknown interpreted text role > "list". > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_NLDAS_forcingA_files:15: WARNING: Block quote ends without a blank > line; unexpected unindent. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_WRF_2d_files:14: ERROR: Unexpected indentation. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_WRF_2d_files:1: ERROR: Unknown interpreted text role "list". > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_WRF_2d_files:1: ERROR: Unknown interpreted text role "list". > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_WRF_2d_files:15: WARNING: Block quote ends without a blank line; > unexpected unindent. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_WRF_2d_files_RAIN:10: ERROR: Unexpected indentation. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_WRF_2d_files_RAIN:1: ERROR: Unknown interpreted text role "list". > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_WRF_2d_files_RAIN:11: WARNING: Block quote ends without a blank > line; unexpected unindent. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_dataset_from_multiple_netcdf_files:8: ERROR: Unexpected > indentation. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_dataset_from_multiple_netcdf_files:9: WARNING: Block quote ends > without a blank line; unexpected unindent. > /usr/local/climate/ocw/data_source/local.py:docstring of > local.load_dataset_from_multiple_netcdf_files:21: ERROR: Unknown interpreted > text role "list". > /usr/local/climate/ocw/dataset.py:docstring of > dataset.Dataset.spatial_resolution:5: WARNING: Block quote ends without a > blank line; unexpected unindent. > /usr/local/climate/ocw/dataset_processor.py:docstring of > dataset_processor.temperature_unit_conversion:6: WARNING: Field list ends > without a blank line; unexpected unindent. > looking for now-outdated files... none found > pickling environment... done > checking consistency... > /usr/local/climate/docs/source/config/config_writer.rst:: WARNING: document > isn't included in any toctree > /usr/local/climate/docs/source/config/dataset_information.rst:: WARNING: > document isn't included in any toctree > /usr/local/climate/docs/source/config/evaluation_settings.rst:: WARNING: > document isn't included in any toctree > /usr/local/climate/docs/source/config/metrics_information.rst:: WARNING: > document isn't included in any toctree > /usr/local/climate/docs/source/config/plots_settings.rst:: WARNING: document > isn't included in any toctree > done > preparing documents... done > writing output... [100%] ui-backend/backend > writing additional files... genindex http-routingtable py-modindex search > copying static files... WARNING: html_static_path entry > u'/usr/local/climate/docs/source/_static' does not exist > done > copying extra files... done > dumping search index... done > dumping object inventory... done > build succeeded, 27 warnings. > {code} -- This message was sent by Atlassian JIRA (v6.3.4#6332)