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:39:27 GMT

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

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

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

    https://github.com/apache/flink/pull/1298#discussion_r43157321
  
    --- Diff: flink-contrib/flink-tweet-inputformat/src/main/java/org/apache/flink/contrib/tweetinputformat/model/tweet/entities/Entities.java
---
    @@ -21,8 +21,8 @@
     import java.util.List;
     
     /**
    - * Entities which have been parsed out of the text of the
    - * {@link package org.apache.flink.contrib.tweetinputformat.model.tweet.Tweet}.
    + * entities which have been parsed out of the text of the
    --- End diff --
    
    Good point. Didn't intend to lower that case.


> 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