Bug 1495145

Summary: FTBFS in F27: javadoc doclint issues
Product: [Fedora] Fedora Reporter: Honza Horak <hhorak>
Component: stringtemplateAssignee: Mikolaj Izdebski <mizdebsk>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: high    
Version: 27CC: lef, walters, xjakub
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: 3.2.1-16 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-01-05 11:05:46 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1495146    
Attachments:
Description Flags
proposed patch none

Description Honza Horak 2017-09-25 09:52:56 UTC 
Description of problem:
Package fails to build in F27:

 [mkdir] Created dir: /builddir/build/BUILD/stringtemplate-3.2.1/docs/api
  [javadoc] Generating Javadoc
  [javadoc] Javadoc execution
  [javadoc] Loading source files for package org.antlr.stringtemplate...
  [javadoc] Loading source files for package org.antlr.stringtemplate.language...
  [javadoc] Loading source files for package org.antlr.stringtemplate.misc...
  [javadoc] Loading source files for package org.antlr.stringtemplate.test...
  [javadoc] Constructing Javadoc information...
  [javadoc] Standard Doclet version 1.8.0_144
  [javadoc] Building tree for all the packages and classes...
  [javadoc] /builddir/build/BUILD/stringtemplate-3.2.1/build/src/org/antlr/stringtemplate/StringTemplateWriter.java:56: warning: no @param for str
  [javadoc] 	int write(String str) throws IOException;
  [javadoc] 	    ^
  [javadoc] /builddir/build/BUILD/stringtemplate-3.2.1/build/src/org/antlr/stringtemplate/StringTemplateWriter.java:56: warning: no @return
  [javadoc] 	int write(String str) throws IOException;
  [javadoc] 	    ^
  [javadoc] /builddir/build/BUILD/stringtemplate-3.2.1/build/src/org/antlr/stringtemplate/StringTemplateWriter.java:56: warning: no @throws for java.io.IOException
  [javadoc] 	int write(String str) throws IOException;

... and may more

Scratch build: https://koji.fedoraproject.org/koji/taskinfo?taskID=22070894

Version-Release number of selected component (if applicable):
stringtemplate-3.2.1-14.fc27

How reproducible:
everytime

Steps to Reproduce:
1. build the package in F27

Actual results:
build fails

Expected results:
build succeeds

Additional info:
Comment 1 Honza Horak 2017-09-25 09:55:10 UTC 
Created attachment 1330468 [details]
proposed patch

This patch works for the scratch build
Comment 2 Honza Horak 2017-09-25 15:24:26 UTC 
Or if you provide me access to the pagure, I can fix it for you :) ...cause it's blocking us when building cassandra module currently :(
Comment 3 Mikolaj Izdebski 2017-10-02 08:39:22 UTC 
Fixed in stringtemplate-3.2.1-15
Comment 4 Mikolaj Izdebski 2018-01-05 11:05:46 UTC 
I believe that this bug is fixed in stringtemplate-3.2.1-16,
which is available in updates for Fedora 27, so I am closing this bug now.

The build containing the fix can be found at Koji:
http://koji.fedoraproject.org/koji/buildinfo?buildID=1009666