Comments (7)
It would seem reasonable to prefer .pod over .pm, if you wouldn't want to use that it wouldn't be there.
from app-modulebuildtiny.
This is actually more tricky than expected, because some metadata ($VERSION
in particular) always needs to come from the .pm
file, but other metadata could come from both.
from app-modulebuildtiny.
Yes, I ran into that while testing possible proposals for code changes.
While I've come up with a working scheme for "falling back" on the pm file
for missing information, I've been hesitant to propose it.
In my situation, I'm working on generating POD from special comments -
comments similar to what Perl6 provides. Of course, it still makes sense to
include some POD in the pm file, which is just passed through as-is.
So, I've been working to enhance my POD generator to extract information
information from POD in the pm file.
That does lead to another to another idea I might propose. Still working on
a demonstration.
On Fri, Mar 25, 2016 at 3:04 PM, Leon Timmermans [email protected]
wrote:
This is actually more tricky than expected, because some metadata (
$VERSION in particular) always needs to come from the .pm file, but other
metadata could come from both.—
You are receiving this because you authored the thread.
Reply to this email directly or view it on GitHub
#14 (comment)
from app-modulebuildtiny.
I don't understand what information you would want to extract from a .pod file if the .pm is present. Could you give an example? Also since the addition of the metamerge file it can be much easier to tweak up the discovered data with your own data.
from app-modulebuildtiny.
On Sat, Mar 26, 2016 at 3:18 PM, Joel Berger [email protected]
wrote:
I don't understand what information you would want to extract from a .pod
file if the .pm is present. Could you give an example? Also since the
addition of the metamerge file it can be much easier to tweak up the
discovered data with your own data.
For various reasons, some projects put the documentation in a separate pod
file. Since some of the information extracted by mbtiny (and other similar
tools) is in the "pod comments", then if the POD is in a separate pod file,
then that file needs to be scanned.
Thinking more, it occurs to me that, in the general case, supporting a
separate pod file will require scanning both the pm and the pod files. I
can clean up and submit my proposed enhancement to App::ModuleBuildTiny to
support this.
For my situation, I could generate a metamerge.json file along side
generating the pod file. I do, however, wonder which other "distribution
build tools" also support metamerge and how.
from app-modulebuildtiny.
I do, however, wonder which other "distribution build tools" also support metamerge and how.
They don't.
from app-modulebuildtiny.
This has been fixed in 0.034
from app-modulebuildtiny.
Related Issues (20)
- Create/update a README file? HOT 1
- Support minting a distribution HOT 3
- Add --omit-core=$v option to listdeps HOT 1
- Multiple licenses HOT 6
- uninit value at App/ModuleBuildTiny.pm line 57 HOT 4
- Invalid links to helper scripts HOT 6
- Support running xt tests HOT 2
- Lack of $VERSION in .pm file gives cryptic error HOT 1
- mbtiny regenerate includes $DISTNAME-$VERSION.tar.gz in MANIFEST HOT 2
- Empty directory should be clearer about what is failing HOT 1
- Falls afoul the dreaded legacy + different version requirements => Wrong result HOT 2
- "Changes appears to be empty" ... not. HOT 2
- Can't call method "fulltext" on an undefined value HOT 4
- Symlink handling undefined, leads to Win32 unfriendly tars HOT 3
- Symlinks removed instead of followed HOT 1
- `mbtiny generate` writes files with double encoding to UTF-8 HOT 4
- configure doesn't set up .pause file HOT 1
- Typo in `mbtiny dist --verbose` output HOT 1
- Cannot parse $VERSION from... in newly minted module HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from app-modulebuildtiny.