flink-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (FLINK-2559) Fix Javadoc Code Examples
Date Tue, 27 Oct 2015 17:13:27 GMT

    [ https://issues.apache.org/jira/browse/FLINK-2559?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14976753#comment-14976753
] 

ASF GitHub Bot commented on FLINK-2559:
---------------------------------------

Github user fhueske commented on a diff in the pull request:

    https://github.com/apache/flink/pull/1298#discussion_r43153270
  
    --- Diff: flink-libraries/flink-gelly/src/main/java/org/apache/flink/graph/spargel/MessagingFunction.java
---
    @@ -327,7 +327,7 @@ void setInDegree(long inDegree) {
     
     	/**
     	 * Retrieve the vertex out-degree (number of out-going edges).
    -	 * @return The out-degree of this vertex if the {@link IterationConfiguration#setOptDegrees(boolean)}
    +	 * @return The out-degree of this vertex
    --- End diff --
    
    the `if` part is missing


> Fix Javadoc Code Examples
> -------------------------
>
>                 Key: FLINK-2559
>                 URL: https://issues.apache.org/jira/browse/FLINK-2559
>             Project: Flink
>          Issue Type: Improvement
>            Reporter: Aljoscha Krettek
>            Priority: Minor
>              Labels: starter
>
> Many multiline Javadoc code examples are not correctly rendered. One of the  problems
is that an @ inside a code block breaks the rendering.
> This is an example that works:
> {code}
>  * <pre>{@code
>  *     private static class MyIndexRequestBuilder implements IndexRequestBuilder<String>
{
>  *
>  *         public IndexRequest createIndexRequest(String element, RuntimeContext ctx)
{
>  *             Map<String, Object> json = new HashMap<>();
>  *             json.put("data", element);
>  *
>  *             return Requests.indexRequest()
>  *                 .index("my-index")
>  *                 .type("my-type")
>  *                 .source(json);
>  *         }
>  *     }
>  * }</pre>
> {code}



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message