qpdf icon indicating copy to clipboard operation
qpdf copied to clipboard

why should the installation steps be hard?

Open handhikadj opened this issue 9 months ago • 4 comments

on this: https://qpdf.readthedocs.io/en/stable/installation.html , there are overly verbose informations how to merely install it that it's hard to follow, at least for me can you guys make it like everyone is 5, like:

To install it:

  1. do this
  2. do that
  3. etc
  4. Voila! That's it. You can run qpdf on terminal

handhikadj avatar Apr 11 '25 17:04 handhikadj

  1. Install the dependecies (How depends on your system).
  2. Build using Cmake (cmake -S . -B build && cmake --build build).
  3. Install using Cmake (cmake --install).
  4. Voila! (If not, check the excellent detailed instructions that for sure covers your specfic case as well as the many others that don't concern you but other users). 😉

mschilli87 avatar Apr 11 '25 17:04 mschilli87

My writing is overly verbose. I always welcome suggestions on streamlining and simplifying. Adding some Tl;Dr bits to the docs would be a good exercise.

jberkenbilt avatar Apr 11 '25 18:04 jberkenbilt

I don't think the section on building and installing is overly verbose.

I think the section on downloading qpdf is too short. There is a bit more information in README-what-to-download, however, this is not mentioned in the manual and in any case is probably still to terse for less experienced users.

Perhaps the headings should be changed:

  • Downloading and Installing qpdf
  • Building and Installing qpdf from Source

m-holger avatar Apr 11 '25 20:04 m-holger

@handhikadj , on which operating system are you trying to install qpdf?

m-holger avatar Apr 11 '25 20:04 m-holger