[
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 <[email protected]>
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)
