Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.Sign up
GitHub is where the world builds software
Millions of developers and companies build, ship, and maintain their software on GitHub — the largest and most advanced development platform in the world.
syscall: document that documentation is platform specific #4051
The syscall package is highly platform specific and the documentation seems to be generated only for the platform the generator is running on (amd64-linux in the case of http://tip.golang.org/pkg/syscall/ apparently). This leads to a lack of mention for any other platform's functions, such as Exchangedata on Darwin, which is however available on that platform. Furthermore the documentation doesn't describe what's available on which platform, which would be highly useful.
AFAIK use of the syscall package is at least somewhat discouraged (among other things code using it is inherently unportable), and I think in part the lack of documentation is to discourage users. Perhaps what would help is to document this situation more clearly, and explain under what circumstances is recommended to use or not use the syscall package.