[ https://issues.apache.org/jira/browse/MAHOUT-913?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13162848#comment-13162848 ]
Hudson commented on MAHOUT-913: ------------------------------- Integrated in Mahout-Quality #1225 (See [https://builds.apache.org/job/Mahout-Quality/1225/]) MAHOUT-913 many small style changes srowen : http://svn.apache.org/viewcvs.cgi/?root=Apache-SVN&view=rev&rev=1210428 Files : * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/hadoop/TasteHadoopUtils.java * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/hadoop/als/ALSUtils.java * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/hadoop/item/RecommenderJob.java * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/hadoop/preparation/PreparePreferenceMatrixJob.java * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/impl/common/RunningAverageAndStdDev.java * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/impl/model/file/FileDataModel.java * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/impl/recommender/knn/KnnItemBasedRecommender.java * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/impl/recommender/slopeone/MemoryDiffStorage.java * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/impl/recommender/slopeone/file/FileDiffStorage.java * /mahout/trunk/core/src/main/java/org/apache/mahout/cf/taste/impl/similarity/TanimotoCoefficientSimilarity.java * /mahout/trunk/core/src/main/java/org/apache/mahout/classifier/ConfusionMatrix.java * /mahout/trunk/core/src/main/java/org/apache/mahout/classifier/ResultAnalyzer.java * /mahout/trunk/core/src/main/java/org/apache/mahout/classifier/df/Bagging.java * /mahout/trunk/core/src/main/java/org/apache/mahout/classifier/df/mapreduce/inmem/InMemMapper.java * /mahout/trunk/core/src/main/java/org/apache/mahout/classifier/df/mapreduce/partial/PartialBuilder.java * /mahout/trunk/core/src/main/java/org/apache/mahout/classifier/df/mapreduce/partial/Step1Mapper.java * /mahout/trunk/core/src/main/java/org/apache/mahout/classifier/df/ref/SequentialBuilder.java * /mahout/trunk/core/src/main/java/org/apache/mahout/clustering/lda/cvb/CVB0DocInferenceMapper.java * /mahout/trunk/core/src/main/java/org/apache/mahout/clustering/lda/cvb/CVB0Driver.java * /mahout/trunk/core/src/main/java/org/apache/mahout/clustering/lda/cvb/CachingCVB0Mapper.java * /mahout/trunk/core/src/main/java/org/apache/mahout/clustering/lda/cvb/CachingCVB0PerplexityMapper.java * /mahout/trunk/core/src/main/java/org/apache/mahout/clustering/lda/cvb/InMemoryCollapsedVariationalBayes0.java * /mahout/trunk/core/src/main/java/org/apache/mahout/clustering/lda/cvb/ModelTrainer.java * /mahout/trunk/core/src/main/java/org/apache/mahout/clustering/lda/cvb/TopicModel.java * /mahout/trunk/core/src/main/java/org/apache/mahout/clustering/spectral/eigencuts/EigencutsDriver.java * /mahout/trunk/core/src/main/java/org/apache/mahout/clustering/spectral/kmeans/SpectralKMeansDriver.java * /mahout/trunk/core/src/main/java/org/apache/mahout/common/AbstractJob.java * /mahout/trunk/core/src/main/java/org/apache/mahout/common/MemoryUtil.java * /mahout/trunk/core/src/main/java/org/apache/mahout/common/distance/MahalanobisDistanceMeasure.java * /mahout/trunk/core/src/main/java/org/apache/mahout/fpm/pfpgrowth/FPGrowthDriver.java * /mahout/trunk/core/src/main/java/org/apache/mahout/math/MatrixUtils.java * /mahout/trunk/core/src/main/java/org/apache/mahout/math/hadoop/decomposer/DistributedLanczosSolver.java * /mahout/trunk/core/src/main/java/org/apache/mahout/math/hadoop/decomposer/EigenVerificationJob.java * /mahout/trunk/core/src/main/java/org/apache/mahout/math/hadoop/decomposer/HdfsBackedLanczosState.java * /mahout/trunk/core/src/main/java/org/apache/mahout/math/hadoop/solver/DistributedConjugateGradientSolver.java * /mahout/trunk/core/src/main/java/org/apache/mahout/math/hadoop/stochasticsvd/SparseRowBlockWritable.java * /mahout/trunk/core/src/main/java/org/apache/mahout/math/hadoop/stochasticsvd/YtYJob.java * /mahout/trunk/core/src/main/java/org/apache/mahout/math/hadoop/stochasticsvd/qr/QRFirstStep.java * /mahout/trunk/core/src/main/java/org/apache/mahout/math/stats/Sampler.java * /mahout/trunk/core/src/main/java/org/apache/mahout/vectorizer/DictionaryVectorizer.java * /mahout/trunk/core/src/main/java/org/apache/mahout/vectorizer/EncodingMapper.java * /mahout/trunk/core/src/main/java/org/apache/mahout/vectorizer/SimpleTextEncodingVectorizer.java * /mahout/trunk/core/src/main/java/org/apache/mahout/vectorizer/Vectorizer.java * /mahout/trunk/core/src/main/java/org/apache/mahout/vectorizer/VectorizerConfig.java * /mahout/trunk/core/src/main/java/org/apache/mahout/vectorizer/Weight.java * /mahout/trunk/core/src/main/java/org/apache/mahout/vectorizer/collocations/llr/CollocReducer.java * /mahout/trunk/core/src/main/java/org/apache/mahout/vectorizer/collocations/llr/GramKeyPartitioner.java * /mahout/trunk/core/src/test/java/org/apache/mahout/cf/taste/hadoop/als/ParallelALSFactorizationJobTest.java * /mahout/trunk/core/src/test/java/org/apache/mahout/classifier/df/data/DataLoaderTest.java * /mahout/trunk/core/src/test/java/org/apache/mahout/classifier/df/mapreduce/partial/PartialBuilderTest.java * /mahout/trunk/core/src/test/java/org/apache/mahout/classifier/df/mapreduce/partial/PartialSequentialBuilder.java * /mahout/trunk/core/src/test/java/org/apache/mahout/clustering/canopy/TestCanopyCreation.java * /mahout/trunk/core/src/test/java/org/apache/mahout/clustering/lda/TestMapReduce.java * /mahout/trunk/core/src/test/java/org/apache/mahout/clustering/lda/cvb/TestCVBModelTrainer.java * /mahout/trunk/core/src/test/java/org/apache/mahout/common/distance/UserDefinedDistanceMeasure.java * /mahout/trunk/core/src/test/java/org/apache/mahout/graph/linkanalysis/PageRankJobTest.java * /mahout/trunk/core/src/test/java/org/apache/mahout/graph/linkanalysis/RandomWalkWithRestartJobTest.java * /mahout/trunk/core/src/test/java/org/apache/mahout/math/hadoop/MathHelper.java * /mahout/trunk/core/src/test/java/org/apache/mahout/math/hadoop/decomposer/TestDistributedLanczosSolver.java * /mahout/trunk/core/src/test/java/org/apache/mahout/math/hadoop/solver/TestDistributedConjugateGradientSolverCLI.java * /mahout/trunk/core/src/test/java/org/apache/mahout/math/hadoop/stochasticsvd/SSVDTestsHelper.java * /mahout/trunk/core/src/test/java/org/apache/mahout/math/stats/SamplerTest.java * /mahout/trunk/core/src/test/java/org/apache/mahout/vectorizer/EncodedVectorsFromSequenceFilesTest.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/cf/taste/example/email/FromEmailToDictionaryMapper.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/cf/taste/example/email/MailToRecMapper.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/cf/taste/example/email/MailToRecReducer.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/cf/taste/example/email/MsgIdToDictionaryMapper.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/cf/taste/hadoop/example/als/netflix/NetflixDatasetConverter.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/NewsgroupHelper.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/RunAdaptiveLogistic.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/RunLogistic.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/SGDHelper.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/SGDInfo.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/TestASFEmail.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/TestNewsGroups.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/TrainASFEmail.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/TrainAdaptiveLogistic.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/TrainLogistic.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/classifier/sgd/TrainNewsGroups.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/clustering/syntheticcontrol/canopy/Job.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/clustering/syntheticcontrol/dirichlet/Job.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/clustering/syntheticcontrol/meanshift/Job.java * /mahout/trunk/examples/src/main/java/org/apache/mahout/ga/watchmaker/cd/CDMutation.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/classifier/ConfusionMatrixDumper.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/SequenceFileDumper.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/clustering/ClusterDumper.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/clustering/ClusterWriter.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/AnalyzerTransformer.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/ChainTransformer.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/FPGFormatter.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/IdentityFormatter.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/IdentityTransformer.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/RegexConverterDriver.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/RegexFormatter.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/RegexMapper.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/RegexTransformer.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/RegexUtils.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/regex/URLDecodeTransformer.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/vectors/VectorDumper.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/vectors/arff/ARFFIterator.java * /mahout/trunk/integration/src/main/java/org/apache/mahout/utils/vectors/arff/Driver.java * /mahout/trunk/integration/src/test/java/org/apache/mahout/utils/regex/RegexMapperTest.java * /mahout/trunk/integration/src/test/java/org/apache/mahout/utils/regex/RegexUtilsTest.java * /mahout/trunk/math/src/main/java/org/apache/mahout/math/MurmurHash3.java * /mahout/trunk/math/src/main/java/org/apache/mahout/math/als/AlternatingLeastSquaresSolver.java * /mahout/trunk/math/src/main/java/org/apache/mahout/math/als/ImplicitFeedbackAlternatingLeastSquaresSolver.java * /mahout/trunk/math/src/main/java/org/apache/mahout/math/decomposer/lanczos/LanczosState.java * /mahout/trunk/math/src/test/java/org/apache/mahout/math/MurmurHash3Test.java * /mahout/trunk/math/src/test/java/org/apache/mahout/math/decomposer/lanczos/TestLanczosSolver.java * /mahout/trunk/math/src/test/java/org/apache/mahout/math/solver/TestConjugateGradientSolver.java > Style changes / discussion > -------------------------- > > Key: MAHOUT-913 > URL: https://issues.apache.org/jira/browse/MAHOUT-913 > Project: Mahout > Issue Type: Improvement > Affects Versions: 0.5 > Reporter: Sean Owen > Assignee: Sean Owen > Priority: Minor > Fix For: 0.6 > > Attachments: MAHOUT-913.patch > > > Guys I've still been seeing code committed that doesn't match standard Java > style or a reasonable policy I can imagine. I wanted to talk about it since > I've just been silently changing it and that is not ideal. > This should be easy to get right, as automated tools exist to check and fix > this. I recommend IntelliJ's free Community edition. Flip on even basic > inspections. A hundred things will jump out (that are already jumping out at > me). Most are automatically fixable. > I think that standardized, readable code invites attention, work and care: it > feels like something you want to improve, and don't want to hack up. > I think it helps attract committers. Strong engineering organizations > wouldn't let basic style problems in the codebase, just by using automated > checks. Code reviews don't begin otherwise, and then reviews focus on real > issues like design. We can make a basic effort to approach that level of > quality. Otherwise, people who are used to a higher standard won't be > inclined to participate in the project, and will just fork. > I think it's a prerequisite to fixing real design issues, TODOs, correctness > problems (cloning for instance), and refactorings. This code is not near that > point, and won't get there at this rate. > Personally it makes we want to only support anything I've written, and write > any "next generation" recommender system in a new and separate venture. And > I'm a friendly, and maybe not the only one! So would be great to keep some > focus on quality and design. > Here's a patch showing all the changes I've picked up and made with the IDE > -- *just* basic style issues, and just since the last 2 weeks. The issues > are, among others: > ⁃ Empty javadoc > ⁃ Redundant javadoc ("@param foo the foo") > ⁃ Missing copyright headers > ⁃ Copyright headers not at top of file (sometimes after imports!) > ⁃ Very long lines (>> 120 chars) > ⁃ "throws Exception" not on main() or test method > ⁃ "transient" fields -- should never be used for us > ⁃ Missing @Override > ⁃ Using new Random() > ⁃ Redundant boolean expressions like "foo == true" > ⁃ Unused variables and parameters > ⁃ Unused imports > ⁃ Loops and conditionals without braces > ⁃ Weird literals ("1d") -- This message is automatically generated by JIRA. If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa For more information on JIRA, see: http://www.atlassian.com/software/jira