* at the start of each line not really working

[jcredland]

Reformatting comments such as this doesn't work. It needs to identify that every line begins with a start and insert one at the start of the line when wrapping etc.

	/**
	 * Returns the number of samples that can be read, and a pointer where you 
	 * can start reading the samples.  Two calls may be necessary as the samples
	 * to be read might wrap around in memory.
	 * 
	 * This call doesn't copy the samples to a new buffer so is more efficent for
	 * some tasks, e.g. metering, where you just want to calculate a value from 
	 * the available data.  
	*
	* @returns the number of samples, per channel.
	 */

[jcredland]

Currently the output when rewrapping this is:

	/**
	 * Returns the number of samples that can be read, and a pointer where you 
	 * can start reading the samples.  Two calls may be necessary as the samples
	 * to be read might wrap around in memory.
	 * 
	 * This call doesn't copy the samples to a new buffer so is more efficent
	   for
	 * some tasks, e.g. metering, where you just want to calculate a value from 
	 * the available 
	 *
	 * @returns the number of samples, per channel.
	 */

The expected output is this:

	/**
	 * Returns the number of samples that can be read, and a pointer where you 
	 * can start reading the samples.  Two calls may be necessary as the samples
	 * to be read might wrap around in memory.
	 * 
	 * This call doesn't copy the samples to a new buffer so is more efficent
	 * for some tasks, e.g. metering, where you just want to calculate a value 
	 * from the available data.   
	 *
	 * @returns the number of samples, per channel.
	 */

[stkb]

What language / file extension are you using here? Currently that form only works in Dart, Java, JavaScript, PHP and TypeScript, where it's working fine for me. However since it's also often used in other C languages I was planning to add it to those in the next release.

[stkb]

BTW thanks for the review for the Visual Studio version. Could you open another issue for the other problem you mentioned (indents increasing each time)?

[jcredland]

I'm working in C++ files.

[stkb]

Thanks. I've published an update (1.5.2) that supports this in all c-style languages. It should work as expected now.

Just curious, what documentation tool do you use?

[jcredland]

The markup is for doxygen if that’s what you mean..?

…

On 9 Oct 2017, at 21:50, Steve Baker ***@***.***> wrote: Thanks. I've published an update (1.5.2) that supports this in all c-style languages. It should work as expected now. Just curious, what documentation tool do you use? — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#52 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AGm4eji7VYyrE93iqHWfBSRg9CATI0Itks5sqocegaJpZM4PxTnM>.

[jcredland]

Ps. thanks for the super-prompt fix. I’ll upgrade :)

…

On 9 Oct 2017, at 21:50, Steve Baker ***@***.***> wrote: Thanks. I've published an update (1.5.2) that supports this in all c-style languages. It should work as expected now. Just curious, what documentation tool do you use? — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#52 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AGm4eji7VYyrE93iqHWfBSRg9CATI0Itks5sqocegaJpZM4PxTnM>.

[stkb]

Doxygen yeah thanks. I wasn't farmiliar with it but from a quick look at the docs it seems I'll need to do a couple of things to better support it. Firstly, it supports /*! or //! comment markers (I'll need to support them too). Also it seems you can use latex-style \tags as an alternative to @tags (currently only the latter is supported).

[stkb]

Thanks for the updated review :) Glad it's now working.