Skip to content

is ../CHANGES is still needed/intended #2873

@yarikoptic

Description

@yarikoptic

error message is spit out (and ignored) while building docs,

> /<<PKGBUILDDIR>>/nipype/sphinxext/plot_workflow.py:docstring of nipype.sphinxext.plot_workflow.ImageFile:18: WARNING: toctree references unknown document u'api/generated/nipype.sphinxext.plot_workflow.ImageFile.filenames'
> /<<PKGBUILDDIR>>/doc/changes.rst:9: WARNING: Problems with "include" directive path:
> InputError: [Errno 2] No such file or directory: '../CHANGES'.
> /<<PKGBUILDDIR>>/doc/devel/interface_specs.rst:474: WARNING: Bullet list ends without a blank line; unexpected unindent.
> /<<PKGBUILDDIR>>/doc/devel/testing_nipype.rst:93: WARNING: Unexpected indentation.

which confuses/complicates analysis of actual error leading to failed build e.g. https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=917740 . So I wondered if it is still intended to be used or replaced fully by those changelogs per version and thus include should be fixed up?:

$> git grep CHANGES
...
doc/changes.rst:.. include:: ../CHANGES
...
tools/update_changes.sh:CHANGES=../doc/changelog/1.X.X-changelog

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions