Add command line switches to hptool for additional archives needed for Windows #289
Description
Background:
The Windows build of Haskell Platform has always used some static (but relative to the build) directory locations for ghc documentation, which itself is due to the fact that we do not build ghc for the Windows HP but instead use a pre-built archive (which does not include all the documentation). The hptool continued that tradition of using the static locations. Well, that has bit us on a couple of releases, when I forgot to manually update those directories with the latest docs.
We should add some additional command line switches, applicable to the Windows version of the hptool, which will be used to designate archive files for the ghc docs.
There are 4 files needed:
- GHC user's guide html
- GHC user's guide PDF
- GHC libraries doc html
- Haddock doc html
Uncompressing and untarring these additional archives will take a more execution time for hptool when building HP releases.
Another thing to note is that the hptool currently uses some positional arguments for the ghc archive, stack installer, and the cabal executable. Rather than continue this positional parameters (which is a bit unsafe and might result, e.g., in the cabal and stack files being swapped), I will at least add switches for the new pieces needed for Windows. I could make switches for the other 3 which are currently positional, but it would mean hptool user's would need to change their scripts or hand-written notes, etc.
The changes visible to the hptool user would be these switches. Internally, the Windows specifics in the hptool would need to add to the configuration to store these new parameters, rules to do the uncompression and untarring, and a place to invoke those rules (within an existing rule that allows build platform-specific behavior).