Skip to content

Commit

Permalink
[pyqgis] Ensure that multiline param tags are indented for additional…
Browse files Browse the repository at this point in the history
… lines
  • Loading branch information
nyalldawson committed May 27, 2018
1 parent c864d22 commit 38850bd
Show file tree
Hide file tree
Showing 133 changed files with 600 additions and 576 deletions.
2 changes: 1 addition & 1 deletion python/analysis/auto_generated/network/qgsgraph.sip.in
Expand Up @@ -16,7 +16,7 @@ class QgsGraphEdge
%Docstring

.. versionadded:: 3.0
This class implements a graph edge
This class implements a graph edge
%End

%TypeHeaderCode
Expand Down
Expand Up @@ -31,7 +31,7 @@ Solve shortest path problem using Dijkstra algorithm
:param startVertexIdx: index of the start vertex
:param criterionNum: index of the optimization strategy
:param resultTree: array that represents shortest path tree. resultTree[ vertexIndex ] == inboundingArcIndex if vertex reachable, otherwise resultTree[ vertexIndex ] == -1.
Note that the startVertexIdx will also have a value of -1 and may need special handling by callers.
Note that the startVertexIdx will also have a value of -1 and may need special handling by callers.
:param resultCost: array of the paths costs
%End

Expand Down
Expand Up @@ -13,7 +13,7 @@ class QgsNetworkDistanceStrategy : QgsNetworkStrategy
%Docstring

.. versionadded:: 3.0
Strategy for caclulating edge cost based on its length. Should be
Strategy for caclulating edge cost based on its length. Should be
used for finding shortest path between two points.
%End

Expand Down
Expand Up @@ -13,7 +13,7 @@ class QgsNetworkSpeedStrategy : QgsNetworkStrategy
%Docstring

.. versionadded:: 3.0
Strategy for calculating edge cost based on travel time. Should be
Strategy for calculating edge cost based on travel time. Should be
used for finding fastest path between two points.
%End

Expand Down
Expand Up @@ -20,7 +20,7 @@ class QgsNetworkStrategy
%Docstring

.. versionadded:: 3.0
QgsNetworkStrategy defines strategy used for calculation of the edge cost. For example it can
QgsNetworkStrategy defines strategy used for calculation of the edge cost. For example it can
take into account travel distance, amount of time or money. Currently there are two strategies
implemented in the analysis library: QgsNetworkDistanceStrategy and QgsNetworkSpeedStrategy.
QgsNetworkStrategy implemented using "strategy" design pattern.
Expand Down
Expand Up @@ -15,7 +15,7 @@ class QgsVectorLayerDirector : QgsGraphDirector
%Docstring

.. versionadded:: 3.0
Determine making the graph from vector line layer
Determine making the graph from vector line layer
%End

%TypeHeaderCode
Expand Down Expand Up @@ -46,7 +46,7 @@ Default constructor
:param reverseDirectionValue: value for reversed one-way road
:param bothDirectionValue: value for two-way (bidirectional) road
:param defaultDirection: default direction. Will be used if corresponding
attribute value is not set or does not equal to the given values
attribute value is not set or does not equal to the given values
%End

virtual void makeGraph( QgsGraphBuilderInterface *builder,
Expand Down
Expand Up @@ -14,7 +14,7 @@ class QgsNativeAlgorithms: QgsProcessingProvider
%Docstring

.. versionadded:: 3.0
Native c++ processing algorithm provider.
Native c++ processing algorithm provider.
%End

%TypeHeaderCode
Expand Down
2 changes: 1 addition & 1 deletion python/core/auto_generated/auth/qgsauthcertutils.sip.in
Expand Up @@ -331,7 +331,7 @@ expiration and effective dates, optionally trusts the root CA
:param bundle:
:param useIntermediates: if true the intermediate certs are also checked
:param trustRootCa: if true the CA will be added to the trusted CAs for this validation check (if useIntermediates is false)
this option is ignored and set to false
this option is ignored and set to false

:return: a list of error strings, if the list is empty then the PKI bundle is valid
%End
Expand Down
2 changes: 1 addition & 1 deletion python/core/auto_generated/auth/qgsauthmanager.sip.in
Expand Up @@ -165,7 +165,7 @@ Re-emit a signal to schedule an optional erase of authentication database.
processing state is not ready for interacting with the user, e.g. project is still loading

:param emitted: Setting to false will cause signal to be emitted by the schedule timer.
Setting to true will stop any emitting, but will not stop the schedule timer.
Setting to true will stop any emitting, but will not stop the schedule timer.
%End

QString authManTag() const;
Expand Down
8 changes: 4 additions & 4 deletions python/core/auto_generated/auth/qgsauthmethod.sip.in
Expand Up @@ -78,7 +78,7 @@ Update a network request with authentication components
:param request: The network request to update
:param authcfg: Authentication configuration ID
:param dataprovider: Textual key for a data provider, e.g. 'postgres', that allows
for custom updater code specific to the provider
for custom updater code specific to the provider

:return: Whether the update succeeded
%End
Expand All @@ -91,7 +91,7 @@ Update a network reply with authentication components
:param reply: The network reply object to update
:param authcfg: Authentication configuration ID
:param dataprovider: Textual key for a data provider, e.g. 'postgres', that allows
for custom updater code specific to the provider
for custom updater code specific to the provider

:return: Whether the update succeeded
%End
Expand All @@ -104,7 +104,7 @@ Update data source connection items with authentication components
:param connectionItems: QStringlist of 'key=value' pairs, as utilized in :py:func:`QgsDataSourceUri.connectionInfo()`
:param authcfg: Authentication configuration ID
:param dataprovider: Textual key for a data provider, e.g. 'postgres', that allows
for custom updater code specific to the provider
for custom updater code specific to the provider

:return: Whether the update succeeded
%End
Expand All @@ -117,7 +117,7 @@ Update proxy settings with authentication components
:param proxy:
:param authcfg: Authentication configuration ID
:param dataprovider: Textual key for a data provider, e.g. 'proxy', that allows
for custom updater code specific to the provider
for custom updater code specific to the provider

:return: Whether the update succeeded
%End
Expand Down
12 changes: 6 additions & 6 deletions python/core/auto_generated/effects/qgsblureffect.sip.in
Expand Up @@ -56,7 +56,7 @@ Constructor for QgsBlurEffect.
Sets blur level (strength)

:param level: blur level. Depending on the current blurMethod(), this parameter
has different effects
has different effects

.. seealso:: :py:func:`blurLevel`

Expand All @@ -68,7 +68,7 @@ has different effects
Returns the blur level (strength)

:return: blur level. Depending on the current blurMethod(), this parameter
has different effects
has different effects

.. seealso:: :py:func:`setBlurLevel`

Expand Down Expand Up @@ -98,7 +98,7 @@ Returns the blur method (algorithm) used for performing the blur.
Sets the ``opacity`` for the effect.

:param opacity: double between 0 and 1 inclusive, where 0 is fully transparent
and 1 is fully opaque
and 1 is fully opaque

.. seealso:: :py:func:`opacity`
%End
Expand All @@ -108,7 +108,7 @@ and 1 is fully opaque
Returns the opacity for the effect.

:return: opacity value between 0 and 1 inclusive, where 0 is fully transparent
and 1 is fully opaque
and 1 is fully opaque

.. seealso:: :py:func:`setOpacity`
%End
Expand All @@ -118,7 +118,7 @@ and 1 is fully opaque
Sets the blend mode for the effect

:param mode: blend mode used for drawing the effect on to a destination
paint device
paint device

.. seealso:: :py:func:`blendMode`
%End
Expand All @@ -128,7 +128,7 @@ paint device
Returns the blend mode for the effect

:return: blend mode used for drawing the effect on to a destination
paint device
paint device

.. seealso:: :py:func:`setBlendMode`
%End
Expand Down
32 changes: 16 additions & 16 deletions python/core/auto_generated/effects/qgscoloreffect.sip.in
Expand Up @@ -47,8 +47,8 @@ Creates a new QgsColorEffect effect from a properties string map.
Sets the brightness modification for the effect.

:param brightness: Valid values are between -255 and 255, where 0 represents
no change, negative values indicate darkening and positive values indicate
lightening
no change, negative values indicate darkening and positive values indicate
lightening

.. seealso:: :py:func:`setBrightness`
%End
Expand All @@ -58,8 +58,8 @@ lightening
Returns the brightness modification for the effect.

:return: brightness value. Values are between -255 and 255, where 0 represents
no change, negative values indicate darkening and positive values indicate
lightening
no change, negative values indicate darkening and positive values indicate
lightening

.. seealso:: :py:func:`setBrightness`
%End
Expand All @@ -69,8 +69,8 @@ lightening
Sets the contrast modification for the effect.

:param contrast: Valid values are between -100 and 100, where 0 represents
no change, negative values indicate less contrast and positive values indicate
greater contrast
no change, negative values indicate less contrast and positive values indicate
greater contrast

.. seealso:: :py:func:`setContrast`
%End
Expand All @@ -80,8 +80,8 @@ greater contrast
Returns the contrast modification for the effect.

:return: contrast value. Values are between -100 and 100, where 0 represents
no change, negative values indicate less contrast and positive values indicate
greater contrast
no change, negative values indicate less contrast and positive values indicate
greater contrast

.. seealso:: :py:func:`setContrast`
%End
Expand All @@ -91,8 +91,8 @@ greater contrast
Sets the saturation modification for the effect.

:param saturation: Valid values are between 0 and 2.0, where 1.0 represents
no change, 0.0 represents totally desaturated (grayscale), and positive values indicate
greater saturation
no change, 0.0 represents totally desaturated (grayscale), and positive values indicate
greater saturation

.. seealso:: :py:func:`saturation`
%End
Expand All @@ -102,8 +102,8 @@ greater saturation
Returns the saturation modification for the effect.

:return: saturation value. Values are between 0 and 2.0, where 1.0 represents
no change, 0.0 represents totally desaturated (grayscale), and positive values indicate
greater saturation
no change, 0.0 represents totally desaturated (grayscale), and positive values indicate
greater saturation

.. seealso:: :py:func:`setSaturation`
%End
Expand Down Expand Up @@ -213,7 +213,7 @@ setColorizeOn() is set to true.
Sets the ``opacity`` for the effect.

:param opacity: double between 0 and 1 inclusive, where 0 is fully transparent
and 1 is fully opaque
and 1 is fully opaque

.. seealso:: :py:func:`opacity`
%End
Expand All @@ -223,7 +223,7 @@ and 1 is fully opaque
Returns the opacity for the effect.

:return: opacity value between 0 and 1 inclusive, where 0 is fully transparent
and 1 is fully opaque.
and 1 is fully opaque.

.. seealso:: :py:func:`setOpacity`
%End
Expand All @@ -233,7 +233,7 @@ and 1 is fully opaque.
Sets the blend mode for the effect

:param mode: blend mode used for drawing the effect on to a destination
paint device
paint device

.. seealso:: :py:func:`blendMode`
%End
Expand All @@ -243,7 +243,7 @@ paint device
Returns the blend mode for the effect

:return: blend mode used for drawing the effect on to a destination
paint device
paint device

.. seealso:: :py:func:`setBlendMode`
%End
Expand Down
8 changes: 4 additions & 4 deletions python/core/auto_generated/effects/qgseffectstack.sip.in
Expand Up @@ -56,7 +56,7 @@ Constructor for empty QgsEffectStack.
Creates a new QgsEffectStack effect from a single initial effect.

:param effect: initial effect to add to the stack. The effect will
be cloned, so ownership is not transferred to the stack.
be cloned, so ownership is not transferred to the stack.

:return: new QgsEffectStack containing initial effect
%End
Expand Down Expand Up @@ -88,7 +88,7 @@ Unused for QgsEffectStack, props parameter will be ignored
Appends an effect to the end of the stack.

:param effect: QgsPaintEffect to append. Ownership of the effect will be
transferred to the stack object.
transferred to the stack object.

.. seealso:: :py:func:`insertEffect`
%End
Expand All @@ -99,7 +99,7 @@ Inserts an effect at a specified index within the stack.

:param index: position to insert the effect
:param effect: QgsPaintEffect to insert. Ownership of the effect will be
transferred to the stack object.
transferred to the stack object.

.. seealso:: :py:func:`appendEffect`
%End
Expand All @@ -110,7 +110,7 @@ Replaces the effect at a specified position within the stack.

:param index: position of effect to replace
:param effect: QgsPaintEffect to replace with. Ownership of the effect will be
transferred to the stack object.
transferred to the stack object.
%End

QgsPaintEffect *takeEffect( const int index /TransferBack/ );
Expand Down
14 changes: 7 additions & 7 deletions python/core/auto_generated/effects/qgsgloweffect.sip.in
Expand Up @@ -124,7 +124,7 @@ Sets blur level (strength) for the glow. This can be used to smooth the
output from the glow effect.

:param level: blur level. Values between 0 and 16 are valid, with larger
values indicating greater blur strength.
values indicating greater blur strength.

.. seealso:: :py:func:`blurLevel`
%End
Expand All @@ -134,7 +134,7 @@ values indicating greater blur strength.
Returns the blur level (strength) for the glow.

:return: blur level. Value will be between 0 and 16, with larger
values indicating greater blur strength.
values indicating greater blur strength.

.. seealso:: :py:func:`setBlurLevel`
%End
Expand All @@ -144,7 +144,7 @@ values indicating greater blur strength.
Sets the ``opacity`` for the effect.

:param opacity: double between 0 and 1 inclusive, where 0 is fully transparent
and 1 is fully opaque
and 1 is fully opaque

.. seealso:: :py:func:`opacity`
%End
Expand All @@ -154,7 +154,7 @@ and 1 is fully opaque
Returns the opacity for the effect.

:return: opacity value between 0 and 1 inclusive, where 0 is fully transparent
and 1 is fully opaque
and 1 is fully opaque

.. seealso:: :py:func:`setOpacity`
%End
Expand Down Expand Up @@ -214,7 +214,7 @@ is set to ColorRamp. The glow will utilize colors from the ramp.
Sets the blend mode for the effect

:param mode: blend mode used for drawing the effect on to a destination
paint device
paint device

.. seealso:: :py:func:`blendMode`
%End
Expand All @@ -224,7 +224,7 @@ paint device
Returns the blend mode for the effect

:return: blend mode used for drawing the effect on to a destination
paint device
paint device

.. seealso:: :py:func:`setBlendMode`
%End
Expand Down Expand Up @@ -272,7 +272,7 @@ Specifies whether the glow is drawn outside the picture or within
the picture.

:return: true if glow is to be drawn outside the picture, or false
to draw glow within the picture
to draw glow within the picture
%End


Expand Down

0 comments on commit 38850bd

Please sign in to comment.