Plugin not working with Maven on Mac about markdowndoc

[tombensve]

Hmm ... I have not been receiving mail notification on activity in issues!

I found "Comments on Issues and Pull Requests [ ]" for email in setting unchecked! If that is default value then that is rather bad. It is now checked!

As I understand it the issue is now resolved.

There is now also a 2.1.5 but only contains build fixes due to Bintray shutting down.

<repositories>
    <repository>
        <id>natusoft-repo</id>
        <name>NS GitHub stuff repo</name>
        <url>https://download.natusoft.se/maven</url>
    </repository>
</repositories>

is now needed to get binaries. I've been looking at maven central again, but it is still rather complicated, still working against easy open sharing of open source binaries. I'm doing this on my free time, and I'm not about to let a company like sonatype waste my time. With Bintray it was trivial.

There is also a 3.0.0 coming that does not provide new functionality either, but bumps Groovy to version 3 and does some code cleanup, like missed @CompileStatic on some classes!

[Arkinator]

Thanks for reporting that bug! Same problem for me, was about to loose my sanity or report that bug for myself.
My pom looks like that:

<build>
        <plugins>
            <plugin>
                <groupId>se.natusoft.tools.doc.markdowndoc</groupId>
                <artifactId>markdowndoc-maven-plugin</artifactId>
                <version>2.1.2</version>

                <executions>
                    <execution>
                        <id>generate-docs</id>
                        <goals>
                            <goal>doc</goal>
                        </goals>
                        <phase>install</phase>
                        <configuration>

                            <generatorOptions>
                                <generator>pdf</generator>
                                <inputPaths>README.md</inputPaths>
                            </generatorOptions>

                            <pdfGeneratorOptions>
                                <resultFile>blub.pdf</resultFile>
                            </pdfGeneratorOptions>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

I tried various placeholders and different paths, to no avail.

[tombensve]

Github is telling me that I'm supposed to get notifications, but I'm not!! I haven't seen this until now!

I will look at this ASAP!

[tombensve]

OK, I have read this over and over and fail to understand exactly what is it that is not working ? What is the problem ? I can see a lot of debug output, but not failures or error messages.

There is one thing I'm seeing:

No document source files were specified, and thus nothing were generated!

This means that none of the source files specified were found! And yes, there could be a better error message for that case :-).

In the 2 cases above I see:

<inputPaths>CHANGELOG.md</inputPaths>

and

<inputPaths>README.md</inputPaths>

Are these files at the root of the project ? Or are those in the root of a maven sub module ? Input files should always be specified relative to top level (root) POM! If specified relative to its own module then it will work when the module is built alone, but fail when the whole project is built.

For example from MarkdownDocs own submodule Docs:

Docs/src/MarkdownDocUserGuideStart.md

That is a full path from top root. Docs is a submodule.

That it works on Windows but not on Mac is however strange. I'm using MarkdownDoc on both Windows (10) and Mac and have never seen any behavior difference.

---

It would also be interesting to know what JDK version you are using ? I've run MarkdownDoc upp to JDK 11 without problems. As of JDK 12 there will be problems and it will be impossible to support both pre 12 and post 12 without 2 different versions. Personally I think that the JDK people have lost their minds.

[Damounet]

Hello,

Haven't got any notification on your answer too, will check that too ! :D

So yes both the pom.xml, CHANGELOG.md and README.md are under the same root folder of the application.
The maven app does not have any module, it's a simple maven application.

My Java version is

java version "1.8.0_161"
Java(TM) SE Runtime Environment (build 1.8.0_161-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.161-b12, mixed mode)

I can't provide you access to the source code of the application, but if you want anything else, don't hesitate to contact me.

[r4fterman]

Just wanted to add my 2ct.
Plugin in Version 2.1.4 is working fine on my Mac and Maven:

          <plugin>
                <groupId>se.natusoft.tools.doc.markdowndoc</groupId>
                <artifactId>markdowndoc-maven-plugin</artifactId>
                <version>2.1.4</version>
                <executions>
                    <execution>
                        <id>generate-docs</id>
                        <goals>
                            <goal>doc</goal>
                        </goals>
                        <phase>install</phase>
                        <configuration>

                            <generatorOptions>
                                <generator>pdf</generator>
                                <inputPaths>${project.basedir}/README.md</inputPaths>
                            </generatorOptions>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

Mac Version: 11.2.3 (Big Sur)
Maven Version: Apache Maven 3.6.3

[Damounet]

Thanks @r4fterman for the update.

Tested again on my mac and it seems to work fine with version 2.1.4

I close the issue as it resolved itself by magic :D