View Issue Details

IDProjectCategoryView StatusLast Update
0002421Spring engineLinuxpublic2013-08-06 01:18
Reporterabma Assigned Tohoijui  
PrioritynormalSeverityminorReproducibilityalways
Status resolvedResolutionfixed 
Product Version0.82.7+git 
Target Version83.0 
Summary0002421: README.html is installed into {INSTALL_PREFIX}/userdocs
Descriptionimo this is wrong, it should be installed into usr/share/doc/spring


see
https://github.com/spring/spring/blob/master/doc/CMakeLists.txt#L74
for details
TagsNo tags attached.
Checked infolog.txt for Errors

Activities

hoijui

2011-06-30 19:02

reporter   ~0006833

Last edited: 2011-06-30 19:07

SKIP to the next comment!

as an example, on my system (Gentoo)
> find /usr/share/doc/gdb-7.0.1/
/usr/share/doc/gdb-7.0.1/
/usr/share/doc/gdb-7.0.1/README.bz2
/usr/share/doc/gdb-7.0.1/sim
/usr/share/doc/gdb-7.0.1/sim/ChangeLog.bz2
/usr/share/doc/gdb-7.0.1/sim/gdbinit.sample.bz2
/usr/share/doc/gdb-7.0.1/sim/MAINTAINERS.bz2
/usr/share/doc/gdb-7.0.1/sim/README-HACKING.bz2
/usr/share/doc/gdb-7.0.1/gdb
/usr/share/doc/gdb-7.0.1/gdb/ChangeLog.bz2
/usr/share/doc/gdb-7.0.1/gdb/README.bz2
/usr/share/doc/gdb-7.0.1/gdb/CONTRIBUTE.bz2
/usr/share/doc/gdb-7.0.1/gdb/PROBLEMS.bz2
/usr/share/doc/gdb-7.0.1/gdb/MAINTAINERS.bz2
/usr/share/doc/gdb-7.0.1/gdb/NEWS.bz2

the bz2 files contain plain/text versions (README.bz2 contains README)

questions:
* how does it look on other systems (Ubuntu)?
* would we have to do the bzip2-ing?
* is the dir versioned too in Ubuntu?

If we need the version, we should wait with this change until the version stuff in CMake is finished and committed (i have it practically finished, but am waiting for final branching model decisions).

hoijui

2011-06-30 19:26

reporter   ~0006834

.. or just ask the internet! ;-)

after reading some about /usr/share/doc,
i am now convinced that we should not compress the individual files, but have the versioned dir.
We should also install the plain/text version of files (remove .markdown suffix on install), and optionally the html versions.
all in all, it might look like:

/usr/share/doc/spring-0.83.0/engine/AUTHORS
/usr/share/doc/spring-0.83.0/engine/AUTHORS.html
/usr/share/doc/spring-0.83.0/engine/README
/usr/share/doc/spring-0.83.0/engine/README.html
/usr/share/doc/spring-0.83.0/engine/COPYING
/usr/share/doc/spring-0.83.0/engine/COPYING.html
/usr/share/doc/spring-0.83.0/engine/FAQ
/usr/share/doc/spring-0.83.0/engine/FAQ.html
/usr/share/doc/spring-0.83.0/engine/LICENSE
/usr/share/doc/spring-0.83.0/engine/LICENSE.html
/usr/share/doc/spring-0.83.0/engine/THANKS
/usr/share/doc/spring-0.83.0/engine/THANKS.html
/usr/share/doc/spring-0.83.0/engine/doc/gpl-2.0.txt
/usr/share/doc/spring-0.83.0/engine/doc/gpl-2.0.html
/usr/share/doc/spring-0.83.0/engine/doc/gpl-3.0.txt
/usr/share/doc/spring-0.83.0/engine/doc/gpl-3.0.html

the doc dir is required for relative links to work (like in the source dir).

abma

2011-07-03 14:09

administrator   ~0006878

is that fixed?

hoijui

2011-07-03 14:51

reporter   ~0006880

no, the version part is still missing.
but other then that, done, yes. :-)

abma

2013-08-06 01:18

administrator   ~0011197

package mantainers mostly "fix" such stuff... don't see why this bug report should be kept open (->workaround exists)

Issue History

Date Modified Username Field Change
2011-05-09 04:07 abma New Issue
2011-05-09 04:07 abma Description Updated
2011-06-10 16:29 hoijui Target Version => 0.83.0
2011-06-30 19:02 hoijui Note Added: 0006833
2011-06-30 19:07 hoijui Note Edited: 0006833
2011-06-30 19:26 hoijui Note Added: 0006834
2011-07-03 14:09 abma Note Added: 0006878
2011-07-03 14:51 hoijui Note Added: 0006880
2011-07-08 14:18 hoijui Status new => assigned
2011-07-08 14:18 hoijui Assigned To => hoijui
2013-08-06 01:18 abma Note Added: 0011197
2013-08-06 01:18 abma Status assigned => resolved
2013-08-06 01:18 abma Resolution open => fixed