DOC: Updates to installation documentation

[ljlamarche]

Description

This PR makes some updates and clarifications to the apexpy installation instructions, specifically troubleshooting unusual cases. Addresses https://github.com/aburrell/apexpy/issues/101 by specifying apexpy has not been tested with versions of gfortran below v7.

Type of change

• Bug fix (non-breaking change which fixes an issue)
• This change is a documentation update

How Has This Been Tested?

Compiled sphinx documentation locally.

Test Configuration:

• Operating system: MacOS
• Python version number: 3.9

Checklist:

• [x] Make sure you are merging into the develop (not main) branch
• [ ] My code follows the style guidelines of this project
• [x] I have performed a self-review of my own code
• [ ] I have commented my code, particularly in hard-to-understand areas
• [ ] I have made corresponding changes to the documentation
• [ ] My changes generate no new warnings
• [ ] I have added tests that prove my fix is effective or that my feature works
• [ ] New and existing unit tests pass locally with my changes
• [ ] Any dependent changes have been merged and published in downstream modules
• [ ] Add a note to Changelog.rst, summarising the changes
• [x] Add yourself to AUTHORS.rst and .zenodo.json

[ljlamarche]

Is numpy still required to be pre-installed with the new build system?

[aburrell]

I think not. I believe it will grab it, and just check if you have it locally.

From: Leslie Lamarche @.> Reply-To: aburrell/apexpy @.> Date: Thursday, December 1, 2022 at 12:42 To: aburrell/apexpy @.> Cc: Subscribed @.> Subject: Re: [aburrell/apexpy] DOC: Updates to installation documentation (PR #102)

Is numpy still required to be pre-installed with the new build system?

— Reply to this email directly, view it on GitHubhttps://github.com/aburrell/apexpy/pull/102#issuecomment-1334125844, or unsubscribehttps://github.com/notifications/unsubscribe-auth/ABVYF7XQLX677HLMCUPSZ3DWLDPP7ANCNFSM6AAAAAASRBMAGU. You are receiving this because you are subscribed to this thread.Message ID: @.***>

[aburrell]

The test failure issues are fixed in #98

[ljlamarche]

Does apexpy require just gfortran or also gcc? Or do you only need gcc if you're building it locally?

[aburrell]

Does apexpy require just gfortran or also gcc? Or do you only need gcc if you're building it locally?

You need gcc and gfortran if you're installing using anything other than a wheel.

[ljlamarche]

@aburrell , can you read through this version of the installation page? It's supposed to be geared towards what the installation process WILL be in v2.0.0, but I wasn't sure about some of it.

[ljlamarche]

Awesome, I accepted your suggestions! Feel free to merge when convenient!