Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
Is there a docset for Boost? I'ld like to add it to Dash for offline documentation search, and can't find one anywhere. All attempts of my own to build it have failed, rather spectacularly.
Not that I've found; they don't even offer a complete set of offline docs, let alone a Dash docset. (Alas, the PDFs that Marchall Clow mentions are only a small subset.)
I've been toying with the idea of creating one, but like you I gave up in frustration. If you want to collaborate, drop me a line!
As I understand it, you'd need to:
Create an offline mirror of the entire set of Boost docs. This is easy enough, something like the following should work:
wget --mirror -p --no-parent --convert-links -P ./boost_docs \
http://www.boost.org/doc/libs/1_53_0/libs/libraries.htm
Index the docs. (This is the hard part.) Scrape the HTML and try and pull out interesting semantic elements: classes, functions, types and so on, and create an index.
Many of the components of Boost seem to use a consistent documentation format, but what complicates things is that many other components have their own, idiosyncratic approach, and their HTML markup is not all semantic. (boost::filesystem's docs appear to have been created using Microsoft Frontpage. I wish I was joking.)
I noticed today that Dash has updated with a Boost Docset, based on Doxygen. Not sure how they got it, but it seems to have everything in there.
Related
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed last month.
Improve this question
This may seem like an odd request, but I'd like to know a way to convert a .chm file to .hlp. Is that at all possible? If so, is there any method I can follow or software I can use to achieve that?
I'm not sure if there are automatic converters for this.
There are CHM decompiler tools, should not be hard to find. This will give you a bunch of HTML files and perhaps some topic/index files. Even the official Microsoft HTML help workshop can help you with this.
To create a .hlp you need to (manually?) convert the HTML files to .rtf if you want to use the official Microsoft compiler. You can probably find it in older SDKs or here or there.
You have to ask yourself, is there any point in doing this? The .hlp format is no longer supported and Windows has not included a viewer for a long time.
If the help file belongs to an application instead of a generic manual or book then there are other things you need to deal with, a different API in the application and you need to port over all topics so they retain their correct id etc. If the HTML included Javascript then you might have a hard time porting those features.
If you are looking for a generic tool, Halibut can generate HLP, CHM and PDF from the same source files. Requires its own input format though.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
I can't seem to find a way to generate documentation for Clojure code on Windows.
Marginalia seems to be broken on all platforms since 1.7 (see here:
https://github.com/gdeer81/marginalia/issues/158).
Codox has an issue
open on this topic (https://github.com/weavejester/codox/issues/110).
The Autodoc plugin for Lein 2 seems to be broken as well (not
enough reputation to post more than two links, but there's an issue
open on this over at GitHub).
Has anyone succeeded in running any of these three on Windows? Should I try something else?
Note:
I do not have a choice here, it must run on Windows.
As I'm building a case for clojure in the company, it must play well with leiningen, which is used to build and test our code.
Another option is autodoc - seems to still be active, but from the README it seems there are no promises it works on windows - still you could give it a try.
I think codox might still be your best bet. It's pretty popular and well maintained (there's only 4 open bugs right now and they're pretty newish - one of which is the one you referenced in your question). So maybe give it some time.
Finally, I know this is probably obvious and not ideal, but you could at least do one-off generations of documentation on a *nix system for the time being.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 6 years ago.
Improve this question
I am looking for a open source tool that can be used to generate ER diagram. Currently, this is done using SchemaSpy. Maven scripts are invoked during jenkins build to generate these data model diagrams. I have tried POCs using SchemaCrawler as well. However, the results are not much satisfactory. Would appreciate if I can get pointers to alternative tools that can be used along with the same setup (maven and jenkins).
If you would like to find out good alternatives to SchemaSpy try to use and test this tools:
SchemaCrawler
Red-Gate SQL Doc (not FOSS)
Dataedo (not FOSS)
SchemaSpy 6.0
Each of them has different advantages and disadvantages SchemaCawler is also open source java based and free. SchemaSpy 6.0 this is new version of SchemaSpy that has better look and feel plus fix some major issue.
Dataedo is very interesting tool that has also possibility to generate documentation to pdf, html. With Dataedo you can write comments of tables and columns and after apply them on your database. As I remember on supplier page you can find also free version.
The last solution that I want to recommend is Red-Gate SQL Doc. This is also generate nice looking documentation and has many options. But as usually this solution is not free you need pay to use it.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 7 years ago.
Improve this question
I'm a LESS user, but I'm considering trying out Sass. Each of them have one big thing that I find attractive, and I'm wondering if both frameworks have equivalents (third-party programs included)
Reason to use Sass (AFAIU):
Sass can be set up to auto-compile into CSS files, saving the need to manually do it
With LESS, the closest is using SimpLESS, but that is still a manual step
Reason to use LESS:
LESS Elements - A set of commonly used mixins (e.g. rounded corners, box-shadow, etc.)
Something similar can be made in Sass, if not available, but I'd like to know if it's already been done
Few things that might clear your doubts:
With LessCSS you include a .js file on your page that doesn't require any other manual step.. That's much simpler than any other method, and I guess you didn't know that.
Less.app for Mac does the work great, and to me, it's better to just launch the app which works than to type "sass --watch etc" in Terminal. Less.app compiles your .less files on every file save, also those which are referenced in the main stylesheet (SimpLESS app doesn't seem to have an option to compile on file save).
I use Twitter's Bootstrap "CSS library/framework" for prototypes/projects, it's fantastic and the code is written in .less format. For me this is a reason I won't switch back to Sass (used it for a while). Check out http://twitter.github.com/bootstrap/
Compass looks good, from what I can see it offers exactly what Bootstrap offers, maybe in a more structured way - but I don't see a demo of what it can offer by default, so I don't see myself using it anytime soon. Also, the $7 app.. sorry, got it for free with Less.app.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 7 years ago.
Improve this question
I am looking for a web based text editor that supports collaboration with 2 or more people.
I am hoping to work on a fairly 'small' project with a couple other people from afar and would really like for us to be able to work on the same file at the same time and see the changes each other make in 'real time'.
Language built on is not much of an issue, would prefer to have syntax highlighting, but not really required.
EtherPad is ideal for realtime collaborative editing, much better than google docs if you're ok with strictly plain text.
Try it out here: http://etherpad.org/
I just tried out CollabEdit for comparison and it seems it really can't handle two people typing at the same time.
See also these similar questions:
How do you collaborate with other coders in real time?
https://stackoverflow.com/questions/148538/what-is-a-great-tool-for-remote-pair
What Features Should Tomorrow's Wiki Include?
google docs would be a save bet. it allows for simultanous editing.
Try out Bespin the new one from Mozilla! It is supposed to have collaboration tools built in, Though I'm not sure if all the features are available yet.
CollabEdit
I saw this linked in another question and it seems to fit the bill 100%, web-based and syntax highlighting.
Have you looked at Google Apps? Myself and two others were using the spreadsheet for planning on a project. You can see the other people moving around their curors and entering text. It's very very cool.
Look at DocSynch
I saw demo of the plugin for eclipse, i dont' remember it's name... maybe this one
Also this wiki page has a list of the collaborative editors.
I hear Mozilla's new "cloud" text editor, Bespin, looks interesting.