Comments (6)
Good idea, will do for next release.
from jq.
Release 1.3 has pregenerated docs.
from jq.
I see the tarball (http://stedolan.github.io/jq/download/source/jq-1.3.tar.gz) has jq.1
pregenerated man page - it would be great to have pregenerated html docs too.
Also, would you consider including both these in the commits? I know it's inefficient, repeating the yml expanded to html, but it would be convenient to not have to install ruby etc to see html docs for the development version.
from jq.
Yeah, the tarballs should probably ship with docs/output prebuilt.
Including the pregenerated stuff in the commits is unlikely to happen. Efficiency isn't the concern. I do actually read the commit logs, especially when debugging, and I don't want every change to be eclipsed with a few hundred lines of manpage and HTML. Also, when merging branches and pull requests, there would almost invariably be conflicts between two branches' versions of generated docs.
Do try RVM if you haven't already (see docs/README.md
). One command will get a Ruby install up and running.
from jq.
Diffs are a really good point. (The merging point is even better.) it might be possible to have a separate branch for them (automatically handled), but a hassle.
I've tried RVM. It's a nightmare, the complex fragmented docs, the different versions of itself. Ruby also is a nightmare, with breaking changes in point releases. It used to be an easy language to get started with, but now is more serving established users/experts/commercial users. Java had this baked in from the start, whereas ruby is a fun, radical language trying to become a suit. </rant>
I'm also running into disk-space limits on my tiny machine, so that's probably the real reason :-). I might try your RVM oneliner https://github.com/stedolan/jq/blob/master/docs/README.md
from jq.
I'm also running into disk-space limits on my tiny machine, so that's probably the real reason
RVM does like to download all of the internet twice. I wouldn't know about its terrible docs, I don't think I've ever read them beyond "copy-paste this line into your shell and suddenly a Ruby appears".
The breaking changes in point releases of Ruby are indeed horrible. The one-liner in README.md downloads the version of Ruby I'm using; I haven't tested others.
from jq.
Related Issues (20)
- Regular expression alternation (|) used with quantifier (* or +) returns inconsistent results when first alternative is able to match an empty string HOT 3
- Create Multi Smaller Files From a Big Json File HOT 5
- Add the Symbolic Binding Operator ("as") to the operator priority table HOT 1
- Including and importing module with importing JSON crashes jq
- The code example for trim ltrim and rtrim from the manual do not work HOT 2
- Incorrect `Invalid path expression` in destructuring expressions
- 1.7.1 dumps core on Cygwin, trying to find the input filename to print an error message HOT 5
- jq --raw modes, --binary and newlines
- Request for snap maintenance HOT 11
- strptime month does not match input HOT 2
- Using unique or unique_by in a filter causes subsequent (after comma ,) filter inputs to be replaced with its output HOT 5
- Docker images lack `latest` tag HOT 2
- modulemeta failure when module location is found by "search"
- oss-fuzz/issues/detail?id=68056
- Unexpected env builtin behaviour HOT 5
- Undefined behaviour in use of <ctype.h> functions
- Add builtin to output to file HOT 5
- Сreating multilevel json with the jq utility in a bash script HOT 2
- More helpful message when passing a JSON-SEQ file without the `--seq` flag HOT 1
- `JV_PRINTF_LIKE` macros in `jv.h` missing fallback definition HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from jq.