docs for the property option of graphs() should include a pointer to the docs for the augment parameter

[jasongrout]

A sentence in the docs for the property parameter should say something about possibly missing graphs, due to the reasons explained in the docs for the augment parameter. See http://groups.google.com/group/sage-devel/browse_thread/thread/e8516faf818a6fb7

Component: documentation

Author: Douglas McNeil

Reviewer: Nathann Cohen, Dmitrii Pasechnik

Merged: sage-4.7.2.rc0

Issue created by migration from https://trac.sagemath.org/ticket/6210

[sagetrac-dsm]

comment:1

Attachment: trac_6210_clarify_graphs_property_argument.patch.gz

I just got bitten by this..

[nathanncohen]

comment:3

Hello !!!

It's true that this part's tricky, but what about just saying after

``property`` -- (default: ``lambda x: True``) any property to be tested on graphs before generation

Something like "The property must fill an inheritance property to work as intended. Please refer to the help of parameter augment" ?

Otherwise the explanations are given twice and we're sure users will read them :-)

Nathann

[kini]

comment:4

We got bitten too, in our undergrad course :) I think I agree with Nathann.

[dimpase]

comment:5

Replying to @kini:

We got bitten too, in our undergrad course :) I think I agree with Nathann.

better more, than less...