-------- Forwarded Message --------
Subject: Re: [Msys2-users] man files for clang
Date: Fri, 30 Dec 2016 23:26:27 -0500
From: David Marceau <[email protected]>
To: Alan W. Irwin <[email protected]>
I was stunned by the fact that you didn't have any man pages installed
so I gave installing clang-4.0-doc a try on Debian sid(unstable).
Same result..no man pages..There is another package with examples, but
that's not what you wanted either.
If you don't want to waste any time or effort, I think it's fair to say
just pretend the clang cli docs are the same as gcc in terms of usage
because that's the intended behaviour...as a drop-in replacement for gcc
except it provides more compiler error verbosity and debugger
information versatility, if I understood correctly.
Myself I have only discovered clang compiling recently golang sources
with it and comparing gcc-compiled golang vs clang-compiled golang.
Others have noted performance advantages when using clang-compiled
golang, but I didn't notice these advantages in my use cases however I
do perceive an advantage when using golang over simple c/c++ in terms of
compile times and run-time performance.
If you really want to refer to official docs:
Until all the man pages surface for clang appear, I would refer to
everything you want about clang/llvm here:
http://www.llvm.org/docs/
If you insist on getting the man tool to deliver something within msys2
and you have a bit of time,
ArchLinux comes with clang 3.9.1 documentation:
/usr/share/man/man1/clang.1.gz
You could cheat by doing a docker install of archlinux and installing
clang there, then copying /usr/share/man/man1/clang.1.gz to your windows
partition into whatever MANPATH and INFOPATH point to.
Then:
man --update clang
If you insist on being masochist and wasting lots of time to get
everyting you want, try compiling everything from scratch. "Linux from
scratch" mentioned:
make docs-clang-html docs-clang-man
in the following:
http://www.linuxfromscratch.org/blfs/view/cvs/general/llvm.html
Lastly, I understand you are using windows with msys2 because you are
constrained to live within the windows world in your institution. I
would highly recommend you find some way to circumvent this constraint
and use a real Linux distro such as ArchLinux or Debian Sid to get the
heavy lifting done and then when absolutely necessary recompile whatever
using msys2 onto windows as a last necessary step. Compiling c/c++ on
windows is slow through msys2 through no-fault of msys2 but of all those
damn-virus checkers checking every file activity at every moment. On
the standard linux distros, you don't have all that
noise/inconvenience/loss of speed when compiling....It is significantly
faster to compile on a Linux box. ArchLinux or Debian are my go-to
distros...more and more ArchLinux is becoming THE go-to distro over
Debian but I will not elaborate why since others have elaborated on that
topic enough.
On 12/30/2016 10:05 PM, Alan W. Irwin wrote:
> On 2016-12-31 01:51+0800 Andrew Lowe wrote:
>
>> Hi all,
>> I'm in the process of upgrading my portable dev environment for my
>> students and happened to notice that there are no clang man pages. My
>> Gentoo linux box has them, so I was wondering how I get them?
>>
>> When I first installed clang, I didn't have man installed so thought
>> they may have been skipped, so after the man install, I reinstalled
>> clang, but to no avail, no clang man pages.
>>
>> Any thoughts on what's up here, greatly appreciated,
>
> I am just lurking here with no actual MSYS2 practical experience yet,
> but this does sound like a packaging bug, and I do have a lot of
> experience building software so I thought I should comment.
>
> Assuming this is a packaging bug, I would look carefully at
> <https://github.com/msys2/MINGW-packages/blob/master/mingw-w64-clang/PKGBUILD>
> to see if you can figure out the issue.
>
> For example, I notice there they relocate man pages, but it is not
> clear whether they are generated properly in the first place because I
> am not that familiar with how to build clang. However, you might get
> some more insight into that by looking at "Beyond Linux from scratch"
> which gives lots of specific recommendations about how to build free
> software packages such as clang. The relevant link for clang is
> <http://www.linuxfromscratch.org/blfs/view/cvs/general/llvm.html>)
> which, for example, does discuss exactly how the man pages should be
> generated.
>
> So I have just skimmed the two URL's I mentioned, but it does appear
> there is a lot for you to absorb from these two places. However, if I
> were in your shoes with a need for an MSYS2 packaging change for
> clang, I would look carefully at the MSYS2 packaging done now for that
> software, make your own private copy of that, analyze exactly what is
> wrong with the man page generation (using sources like above from
> BLFS), fix it, and build the package for your own MSYS2 needs. Then
> once you were satisfied with your packaging update, donate your
> improved package back to MSYS2 so everyone can benefit from what you
> have done.
>
> Alan
> __________________________
> Alan W. Irwin
>
> Astronomical research affiliation with Department of Physics and Astronomy,
> University of Victoria (astrowww.phys.uvic.ca).
>
> Programming affiliations with the FreeEOS equation-of-state
> implementation for stellar interiors (freeeos.sf.net); the Time
> Ephemerides project (timeephem.sf.net); PLplot scientific plotting
> software package (plplot.sf.net); the libLASi project
> (unifont.org/lasi); the Loads of Linux Links project (loll.sf.net);
> and the Linux Brochure Project (lbproject.sf.net).
> __________________________
>
> Linux-powered Science
> __________________________
>
> ------------------------------------------------------------------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, SlashDot.org! http://sdm.link/slashdot
> _______________________________________________
> Msys2-users mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/msys2-users
>
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, SlashDot.org! http://sdm.link/slashdot
_______________________________________________
Msys2-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/msys2-users
