Skip to content

Unable to build docs #1180

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
AStupidBear opened this issue Apr 3, 2017 · 5 comments
Closed

Unable to build docs #1180

AStupidBear opened this issue Apr 3, 2017 · 5 comments

Comments

@AStupidBear
Copy link

Documenter: setting up build directory.                                                                                                       
Documenter: expanding markdown templates.                                                                                                     
WARNING: Method definition require(Symbol) in module Base at loading.jl:345 overwritten in module Query at c:\Users\luyao\.julia\v0.5\Requires
rc\require.jl:12.                                                                                                                             
 !! failed to run `@setup` block.                                                                                                             
                                                                                                                                              
LoadError("string",1,LoadError("C:\\Users\\luyao\\.julia\\v0.5\\Query\\src\\Query.jl",19,LoadError("C:\\Users\\luyao\\.julia\\v0.5\\Query\\src
traits.jl",323,UndefVarError(:IsIterator)))) [src\man\querying_frameworks.md]                                                                 
 !! failed to run code block.                                                                                                                 
                                                                                                                                              
UndefVarError(Symbol("@from")) [src\man\querying_frameworks.md]                                                                               
 !! failed to run code block.                                                                                                                 
                                                                                                                                              
UndefVarError(Symbol("@from")) [src\man\querying_frameworks.md]                                                                               
 !! failed to run code block.                                                                                                                 
                                                                                                                                              
UndefVarError(:q2) [src\man\querying_frameworks.md]                                                                                           
 !! failed to run code block.                                                                                                                 
                                                                                                                                              
UndefVarError(:q2) [src\man\querying_frameworks.md]                                                                                           
 !! failed to run code block.                                                                                                                 
                                                                                                                                              
UndefVarError(Symbol("@from")) [src\man\querying_frameworks.md]                                                                               
Documenter: building cross-references.                                                                                                        
Documenter: running document checks.                                                                                                          
 > checking for missing docstrings.                                                                                                           
 !! 136 docstrings potentially missing:                                                                                                       
                                                                                                                                              
    StatsBase.renyientropy :: Tuple{AbstractArray{T<:Real,N},U<:Real}                                                                         
    StatsBase.autocov :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Integer,1}}                                                          
    StatsBase.proportionmap :: Tuple{AbstractArray}                                                                                           
    StatsBase.adjr2 :: Tuple{StatsBase.StatisticalModel,Symbol}                                                                               
    StatsBase.mean_and_std :: Tuple{AbstractArray{T<:Real,N}}                                                                                 
    StatsBase.ordinalrank :: Tuple{AbstractArray{T<:Real,N}}                                                                                  
    StatsBase.ecdf :: Tuple{AbstractArray{T<:Real,1}}                                                                                         
    StatsBase.moment :: Tuple{AbstractArray{T<:Real,N},Int64,Real}                                                                            
    DataFrames.ContrastsMatrix :: Tuple{C<:DataFrames.AbstractContrasts,AbstractArray{T,1}}                                                   
    Base.convert :: Tuple{Type{DataFrames.ContrastsMatrix{DataFrames.FullDummyCoding,T}},DataFrames.ContrastsMatrix}                          
    DataFrames.@csv2_str :: Tuple{Any,Vararg{Any,N}}                                                                                          
    StatsBase.crosscov :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Real,1},AbstractArray{T<:Integer,1}}                                
    StatsBase.summarystats :: Tuple{AbstractArray{T<:Real,N}}                                                                                 
    DataFrames.termnames :: Tuple{Symbol,Any}                                                                                                 
    StatsBase.inverse_rle :: Tuple{AbstractArray{T,1},AbstractArray{T<:Integer,1}}                                                            
    StatsBase.bic :: Tuple{StatsBase.StatisticalModel}                                                                                        
    StatsBase.maxad :: Tuple{AbstractArray{T<:Number,N},AbstractArray{T<:Number,N}}                                                           
    StatsBase.span :: Tuple{AbstractArray{T<:Integer,N}}                                                                                      
    DataFrames.GroupedDataFrame                                                                                                               
    DataFrames.droprandomeffects :: Tuple{DataFrames.Terms}                                                                                   
    StatsBase.pacf! :: Tuple{AbstractArray{T<:Real,2},AbstractArray{T<:Union{Float32,Float64},2},AbstractArray{T<:Integer,1}}                 
    StatsBase.corspearman :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Real,1}}                                                         
    StatsBase.trimmean :: Tuple{AbstractArray{T<:Real,N},Real}                                                                                
    StatsBase.entropy :: Tuple{AbstractArray{T<:Real,N}}                                                                                      
    StatsBase.deviance :: Tuple{StatsBase.StatisticalModel}                                                                                   
    StatsBase.L1dist :: Tuple{AbstractArray{T<:Number,N},AbstractArray{T<:Number,N}}                                                          
    StatsBase.wsample :: Tuple{AbstractArray{T,N},AbstractArray{T<:Real,1},Integer}                                                           
    StatsBase.wsample :: Tuple{AbstractArray{T<:Real,1}}                                                                                      
    StatsBase.wsample :: Tuple{AbstractArray{T,N},AbstractArray{T<:Real,1},Tuple{Vararg{Int64,N}}}                                            
    DataFrames.@tsv_str :: Tuple{Any,Vararg{Any,N}}                                                                                           
    StatsBase.aicc :: Tuple{StatsBase.StatisticalModel}                                                                                       
    StatsBase.genmean :: Tuple{AbstractArray{T<:Real,N},Real}                                                                                 
    StatsBase.crosscor! :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Union{Float32,Float64},1},AbstractArray{T<:Union{Float32,Float64},1
AbstractArray{T<:Integer,1}}                                                                                                                  
    StatsBase.proportions :: Tuple{AbstractArray{T<:Integer,N},UnitRange{T<:Integer}}                                                         
    StatsBase.proportions :: Tuple{AbstractArray{T<:Integer,N},Integer}                                                                       
    StatsBase.rmsd :: Tuple{AbstractArray{T<:Number,N},AbstractArray{T<:Number,N}}                                                            
    StatsBase.kldivergence :: Tuple{AbstractArray{T<:Real,N},AbstractArray{T<:Real,N}}                                                        
    StatsBase.geomean :: Tuple{AbstractArray{T<:Real,N}}                                                                                      
    StatsBase.samplepair :: Tuple{Int64}                                                                                                      
    StatsBase.samplepair :: Tuple{AbstractArray}                                                                                              
    StatsBase.levelsmap :: Tuple{AbstractArray{T,N}}                                                                                          
    StatsBase.gkldiv :: Tuple{AbstractArray{T<:AbstractFloat,N},AbstractArray{T<:AbstractFloat,N}}                                            
    DataFrames.AbstractContrasts                                                                                                              
    StatsBase.wsample! :: Tuple{AbstractArray,AbstractArray{T<:Real,1},AbstractArray}                                                         
    StatsBase.nulldeviance :: Tuple{StatsBase.StatisticalModel}                                                                               
    StatsBase.wsum :: Tuple{AbstractArray{T,1},AbstractArray{T,1}}                                                                            
    DataFrames.@csv_str :: Tuple{Any,Vararg{Any,N}}                                                                                           
    StatsBase.rle :: Tuple{Array{T,1}}                                                                                                        
    DataFrames.DummyCoding                                                                                                                    
    DataFrames.dropresponse! :: Tuple{DataFrames.Terms}                                                                                       
    StatsBase.denserank :: Tuple{AbstractArray{T<:Real,N}}                                                                                    
    StatsBase.zscore! :: Tuple{AbstractArray{ZT<:AbstractFloat,N},AbstractArray{T<:Real,N},Real,Real}                                         
    StatsBase.ConvergenceException                                                                                                            
    StatsBase.crosscov! :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Union{Float32,Float64},1},AbstractArray{T<:Union{Float32,Float64},1
AbstractArray{T<:Integer,1}}                                                                                                                  
    StatsBase.competerank :: Tuple{AbstractArray{T<:Real,N}}                                                                                  
    DataFrames.RepeatedVector                                                                                                                 
    StatsBase.wmedian :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Real,1}}                                                             
    DataFrames.modelmat_cols :: Tuple{Type{T<:AbstractArray{T<:AbstractFloat,2}},DataArrays.PooledDataArray{T,R,1},DataFrames.ContrastsMatrix}
    DataFrames.groupby :: Tuple{DataFrames.AbstractDataFrame,Array{T,1}}                                                                      
    StatsBase.scattermat                                                                                                                      
    DataFrames.HelmertCoding                                                                                                                  
    StatsBase.mean_and_cov                                                                                                                    
    StatsBase.kurtosis :: Tuple{AbstractArray{T<:Real,N},Real}                                                                                
    StatsBase.weights :: Tuple{AbstractArray{T<:Real,1}}                                                                                      
    StatsBase.L2dist :: Tuple{AbstractArray{T<:Number,N},AbstractArray{T<:Number,N}}                                                          
    DataFrames.aggregate :: Tuple{DataFrames.AbstractDataFrame,Function}                                                                      
    StatsBase.dof :: Tuple{StatsBase.StatisticalModel}                                                                                        
    StatsBase.indexmap :: Tuple{AbstractArray{T,N}}                                                                                           
    DataFrames.EffectsCoding                                                                                                                  
    StatsBase.pacf :: Tuple{AbstractArray{T<:Real,2},AbstractArray{T<:Integer,1}}                                                             
    StatsBase.crosscor :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Real,1},AbstractArray{T<:Integer,1}}                                
    DataFrames.ContrastsCoding                                                                                                                
    StatsBase.crossentropy :: Tuple{AbstractArray{T<:Real,N},AbstractArray{T<:Real,N}}                                                        
    StatsBase.corkendall :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Real,1}}                                                          
    StatsBase.autocor :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Integer,1}}                                                          
    StatsBase.aic :: Tuple{StatsBase.StatisticalModel}                                                                                        
    StatsBase.nobs :: Tuple{StatsBase.StatisticalModel}                                                                                       
    StatsBase.findat :: Tuple{AbstractArray,AbstractArray}                                                                                    
    Base.quantile :: Tuple{AbstractArray{V,1},StatsBase.WeightVec{W<:Real,Vec<:AbstractArray{T<:Real,1}},AbstractArray{T<:Real,1}}            
    Core.Type :: Tuple{DataFrames.ModelFrame}                                                                                                 
    StatsBase.autocov! :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Union{Float32,Float64},1},AbstractArray{T<:Integer,1}}              
    Base.cov                                                                                                                                  
    StatsBase.wquantile :: Tuple{AbstractArray{T<:Real,1},StatsBase.WeightVec{W<:Real,Vec<:AbstractArray{T<:Real,1}},AbstractArray{T<:Real,1}}
    DataFrames.GroupApplied                                                                                                                   
    StatsBase.r2 :: Tuple{StatsBase.StatisticalModel,Symbol}                                                                                  
    StatsBase.countmap :: Tuple{AbstractArray{T,N}}                                                                                           
    DataFrames.@wsv_str :: Tuple{Any,Vararg{Any,N}}                                                                                           
    DataFrames.StackedVector                                                                                                                  
    StatsBase.harmmean :: Tuple{AbstractArray{T<:Real,N}}                                                                                     
    StatsBase.model_response :: Tuple{DataFrames.ModelFrame}                                                                                  
    DataFrames.combine :: Tuple{DataFrames.GroupApplied}                                                                                      
    StatsBase.sample :: Tuple{StatsBase.WeightVec}                                                                                            
    StatsBase.sample :: Tuple{AbstractArray}                                                                                                  
    StatsBase.sample :: Tuple{AbstractArray{T,N},Integer}                                                                                     
    StatsBase.sample :: Tuple{AbstractArray{T,N},Tuple{Vararg{Int64,N}}}                                                                      
    StatsBase.counteq :: Tuple{AbstractArray,AbstractArray}                                                                                   
    StatsBase.sample! :: Tuple{AbstractArray,AbstractArray}                                                                                   
    DataFrames.FullDummyCoding                                                                                                                
    StatsBase.addcounts! :: Tuple{AbstractArray,AbstractArray{T<:Integer,N},UnitRange{T<:Integer}}                                            
    Base.std :: Tuple{AbstractArray{T<:Real,N},StatsBase.WeightVec}                                                                           
    Base.stdm :: Tuple{AbstractArray{T<:Real,N},StatsBase.WeightVec,Real}                                                                     
    StatsBase.tiedrank :: Tuple{AbstractArray{T<:Real,N}}                                                                                     
    StatsBase.modes :: Tuple{AbstractArray{T<:Integer,N},UnitRange{T<:Integer}}                                                               
    StatsBase.autocor! :: Tuple{AbstractArray{T<:Real,1},AbstractArray{T<:Union{Float32,Float64},1},AbstractArray{T<:Integer,1}}              
    StatsBase.iqr :: Tuple{AbstractArray{T<:Real,N}}                                                                                          
    StatsBase.nquantile :: Tuple{AbstractArray{T<:Real,N},Integer}                                                                            
    StatsBase.zscore :: Tuple{AbstractArray{T<:Real,N},Real,Real}                                                                             
    StatsBase.sem :: Tuple{AbstractArray{T<:Real,N}}                                                                                          
    Base.varm :: Tuple{AbstractArray{T<:Real,N},StatsBase.WeightVec,Real}                                                                     
    StatsBase.WeightVec :: Tuple{Vec<:AbstractArray{T<:Real,1},W<:Real}                                                                       
    StatsBase.countne :: Tuple{AbstractArray,AbstractArray}                                                                                   
    DataFrames.colwise :: Tuple{Function,DataFrames.AbstractDataFrame}                                                                        
    StatsBase.counts :: Tuple{AbstractArray{T<:Integer,N},UnitRange{T<:Integer}}                                                              
    StatsBase.counts :: Tuple{AbstractArray{T<:Integer,N},Integer}                                                                            
    DataFrames.inlinetable :: Tuple{AbstractString}                                                                                           
    StatsBase.Linfdist :: Tuple{AbstractArray{T<:Number,N},AbstractArray{T<:Number,N}}                                                        
    StatsBase.mode :: Tuple{AbstractArray{T<:Integer,N},UnitRange{T<:Integer}}                                                                
    StatsBase.meanad :: Tuple{AbstractArray{T<:Number,N},AbstractArray{T<:Number,N}}                                                          
    StatsBase.wsum! :: Tuple{AbstractArray,AbstractArray{T,N},AbstractArray{T,1},Int64}                                                       
    DataFrames.coefnames :: Tuple{DataFrames.ModelFrame}                                                                                      
    StatsBase.sqL2dist :: Tuple{AbstractArray{T<:Number,N},AbstractArray{T<:Number,N}}                                                        
    DataFrames.expandcols :: Tuple{Array{T<:AbstractArray{T<:AbstractFloat,2},1}}                                                             
    StatsBase.msd :: Tuple{AbstractArray{T<:Number,N},AbstractArray{T<:Number,N}}                                                             
    StatsBase.indicatormat :: Tuple{AbstractArray,AbstractArray}                                                                              
    StatsBase.indicatormat :: Tuple{AbstractArray{T<:Integer,N},Integer}                                                                      
    StatsBase.skewness :: Tuple{AbstractArray{T<:Real,N},Real}                                                                                
    Base.var :: Tuple{AbstractArray{T<:Real,N},StatsBase.WeightVec}                                                                           
    StatsBase.predict :: Tuple{StatsBase.RegressionModel}                                                                                     
    StatsBase.wmean :: Tuple{AbstractArray{T<:Number,N},AbstractArray{T,1}}                                                                   
    StatsBase.mad :: Tuple{AbstractArray{T<:Real,N}}                                                                                          
    StatsBase.mad! :: Union{Tuple{AbstractArray{T<:Real,N},Real},Tuple{AbstractArray{T<:Real,N}}}                                             
    StatsBase.percentile :: Tuple{AbstractArray{T<:Real,N},Any}                                                                               
    StatsBase.psnr :: Tuple{AbstractArray{T<:Real,N},AbstractArray{T<:Real,N},Real}                                                           
    StatsBase.variation :: Tuple{AbstractArray{T<:Real,N},Real}                                                                               
    DataFrames.by :: Tuple{DataFrames.AbstractDataFrame,Any,Function}                                                                         
    StatsBase.mean_and_var :: Tuple{AbstractArray{T<:Real,N}}                                                                                 
                                                                                                                                              
 !! Skipped doctesting.                                                                                                                       
 > checking footnote links.                                                                                                                   
Documenter: populating indices.                                                                                                               
Documenter: rendering document.                                                                                                               
Documenter: copying assets to build directory.                                                                                                
 !! Overwriting 'build\assets\Documenter.css'.                                                                                                
 !! Overwriting 'build\assets\mathjaxhelper.js'.                                                                                              
Documenter: skipping docs deployment.                                                                                                         
  You can set DOCUMENTER_DEBUG to "true" in Travis to see more information.                                                                   
@ararslan
Copy link
Member

ararslan commented Apr 3, 2017

Yep, this is a problem when a package includes executable examples from another package in its documentation. Perhaps we could move this to Query.jl's documentation instead? cc @davidanthoff

@davidanthoff
Copy link
Contributor

I believe this error is caused because you are on master for Query, but not for SimpleTraits. I don't think you would see any of these issues if you are on the last released version of Query.

@ararslan I don't think this case is any different than say tests breaking because someone is on a pre-release version of some other package that DataFrames depends on and then things break. I don't really care whether the Query chapter is part of the DataFrames documentation, I added it because @nalimilan suggested that here. If you want to take it out again, I won't protest, but someone else would have to do the actual work and it would be good to sort these kind of things out before people put time into them.

@nalimilan
Copy link
Member

I'd rather keep these tests as we really don't want to have non-working examples in our docs. People should expect breakage if they use the master branch of packages.

@quinnj
Copy link
Member

quinnj commented Sep 7, 2017

Anything actionable here?

@nalimilan
Copy link
Member

No, breakage is to be expected when using unreleased versions of packages. (BTW, Query.jl doctests probably don't pass on master at the moment.)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

5 participants