Hmmm, I can understand your reasoning but I'd rather not make the sources public...
I know that's a massive piece but typically only few chapters are needed. For me it works okay (yes, I have to look things up often myself) with searching in the PDF and a viewer that shows also the document structure (quite important!). Cheers Christian -- Christian Schulte, www.gecode.org/~schulte Professor of Computer Science, KTH, cschu...@kth.se Expert Researcher, SICS, cschu...@sics.se -----Original Message----- From: users-boun...@gecode.org [mailto:users-boun...@gecode.org] On Behalf Of Sebastian Kosch Sent: Friday, January 20, 2017 13:46 To: users@gecode.org Subject: Re: [gecode-users] Number of solutions Hm - that being said, chiming in as a casual user - I've wondered before whether a tex(t) source of the PDF is available. No question: MPG is one of the best piece of documentation I've ever had the pleasure of reading. The breadth and depth and coherence really are an impressive accomplishment. The underlying expectation, though, is that users read it like a textbook - when realistically people just want to google their problem, click, immediately be in the right section, aha, click, there's the link to the function reference, click, open a new tab, etc. When you work with a system as large as Gecode for a few days, constantly going back and forth between scrolling through a massive PDF and looking for corresponding doxygen pages becomes a bit tedious. Yes, a total luxury complaint. I also get that you're worried about a bunch of different versions of the docs floating around. Just maybe if you publish the source people can experiment with pandoc-ing it straight into a doxygen or Sphinx format, and perhaps it'll become apparent that they really find that easier to use? Sebastian On 2017-01-19 09:36 AM, Christian Schulte wrote: > What? That is a real luxury complaint... > > You know how much work it is to write a coherent 500 page document? > That's not that easy to do as html. > > And searching in PDF is not that hard... > > Christian > > -- > Christian Schulte, www.gecode.org/~schulte Professor of Computer > Science, KTH, cschu...@kth.se Expert Researcher, RISE ICT/SICS, > cschu...@sics.se > > > -----Original Message----- > From: users-boun...@gecode.org [mailto:users-boun...@gecode.org] On > Behalf Of Johannes Waldmann > Sent: Thursday, January 19, 2017 15:19 > To: users@gecode.org > Subject: Re: [gecode-users] Number of solutions > >> ... you should read MPG, really > > Seconded. But - (Downloading and) opening a 500 page PDF is rather > heavy. Is there a HTML version, on the web somewhere, with URLs for > sections, so that it's easy to refer to? > > I know there is "online HTML" doc at > http://www.gecode.org/documentation.html > but this refers to the C++ API only (?) E.g., when I search for > "command line" > (expecting to find something towards the answer you gave, "commandline > -solutions 0 -mode stat"), this is not really helpful: > http://www.gecode.org/doc-latest/reference/search.php?query=command+li > ne > > - J.W. > > > _______________________________________________ > Gecode users mailing list > users@gecode.org > https://www.gecode.org/mailman/listinfo/gecode-users > > > > _______________________________________________ > Gecode users mailing list > users@gecode.org > https://www.gecode.org/mailman/listinfo/gecode-users > _______________________________________________ Gecode users mailing list users@gecode.org https://www.gecode.org/mailman/listinfo/gecode-users
smime.p7s
Description: S/MIME cryptographic signature
_______________________________________________ Gecode users mailing list users@gecode.org https://www.gecode.org/mailman/listinfo/gecode-users
