[gecode-users] Number of solutions

[Christian Schulte]

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, cschulte at kth.se
Expert Researcher, SICS, cschulte at sics.se
-----Original Message-----
From: users-bounces at gecode.org [mailto:users-bounces at gecode.org] On Behalf
Of Sebastian Kosch
Sent: Friday, January 20, 2017 13:46
To: users at 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, cschulte at kth.se Expert Researcher, RISE ICT/SICS, 
> cschulte at sics.se
>
>
> -----Original Message-----
> From: users-bounces at gecode.org [mailto:users-bounces at gecode.org] On 
> Behalf Of Johannes Waldmann
> Sent: Thursday, January 19, 2017 15:19
> To: users at 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 at gecode.org
> https://www.gecode.org/mailman/listinfo/gecode-users
>
>
>
> _______________________________________________
> Gecode users mailing list
> users at gecode.org
> https://www.gecode.org/mailman/listinfo/gecode-users
>

_______________________________________________
Gecode users mailing list
users at gecode.org
https://www.gecode.org/mailman/listinfo/gecode-users
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 4599 bytes
Desc: not available
URL: <http://www.gecode.org/pipermail/users/attachments/20170123/c31a323b/attachment.bin>