Skip to content
This repository was archived by the owner on Apr 16, 2018. It is now read-only.

Try to add documentation in socket.hpp #4

Merged
merged 4 commits into from
Feb 24, 2017
Merged

Conversation

tkhurana96
Copy link
Contributor

But at "!!Improve This!!" sentences need to be completed.

@tkhurana96 tkhurana96 requested a review from agauniyal February 23, 2017 15:49
@tkhurana96 tkhurana96 self-assigned this Feb 23, 2017
* @param {callable} _fn Some callable that writes using socket descriptor.
* @param {int} _sockfd Descriptor representing a socket.
* @param {string} _msg Msg to write on _sockfd.
* @param {_______} args Flags, destination sockaddr objects and their lengths. !!Improve This!!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

_____ = parameter_pack

* @param {callable} _fn Some callable that reads using socket descriptor.
* @param {int} _sockfd Descriptor representing a socket.
* @param {string} _str String to store the data.
* @param {_______} args Flags, destination sockaddr objects and their lengths. !!Improve This!!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

_____ = parameter_pack

@@ -9,6 +9,11 @@

namespace net {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please format with clang-format.

void connect(const char[], const int = 0, bool * = nullptr);

/** @method connect
* @access public
* Connects net::Socket to _______ if successful else throws runtime_error exception. !!Improve This!!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

_______ = ipv4 peer


/** @method connect
* @access public
* Connects net::Socket to _______ if successful else throws runtime_error exception. !!Improve This!!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

_______ = ipv6 peer


/** @method connect
* @access public
* Connects net::Socket to _______ if successful else throws runtime_error exception. !!Improve This!!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

_______ = unix socket peer

* Shutdown Socket using net::SF::shut.
*
* @param {net::SF::shut} s Option specifying which side of connection to shutdown for Socket.
*/
void stop(SF::shut s) const noexcept
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please make it _s instead of s both in documentation and function definition.

* Set a socket option from net::SF::opt for Socket using object of type net::SF::sockOpt.
*
* @param {net::SF::opt} _opType Option to set for Socket.
* @param {net::SF::sockOpt} _opValue ___________ !!Improve This!!.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

___________ = socket option structure. Present inside socket_family.hpp

@agauniyal agauniyal added this to the 0.1 milestone Feb 23, 2017
@agauniyal agauniyal changed the base branch from feature/socket-options to feature/socket February 23, 2017 16:19
@tkhurana96
Copy link
Contributor Author

The commit msg was actually: Add clang formatted doc and remove all !!Improve This!! from doc

@agauniyal
Copy link
Member

@tkhurana96 Since no one else is working on your branch, execute this -
git commit --amend -m "Add clang formatted doc and remove all !!Improve This!! comments"

and then execute -
git push -f.

@agauniyal
Copy link
Member

@tkhurana96 there is net::methods inside socket_family.hpp, would you mind adding theirs too.

@agauniyal agauniyal merged commit d7a8a4b into feature/socket Feb 24, 2017
@agauniyal agauniyal deleted the documentation branch February 24, 2017 18:55
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants