Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update "Changes from Version 1 Kernel" to include a "How-To Port Apps" section #3034

Closed
zephyrbot opened this issue Jan 12, 2017 · 4 comments
Assignees
Labels
area: Documentation Enhancement Changes/Updates/Additions to existing features priority: medium Medium impact/importance bug
Milestone

Comments

@zephyrbot
Copy link
Collaborator

zephyrbot commented Jan 12, 2017

Reported by Mark Linkmeyer:

As a Zephyr user, I need the "Changes from Version 1 Kernel" documentation (https://www.zephyrproject.org/doc/doc/kernel/overview/changes.html) to explain how to find and use the legacy.h file to port Zephyr applications from the version 1 kernel to the version 2 kernel. It should also include relevant examples to clearly show how this is done. Note that for ~99% of the APIs it should be a simple search and replace exercise to replace v1 kernel functions with v2 kernel functions. For the remaining 1%, the document must explain how to handle these cases too.

(Imported from Jira ZEP-1571)

@zephyrbot
Copy link
Collaborator Author

by Anas Nashif:

In the porting guide, take a sample, for example "synchronization" from samples/synchronization/ and from samples/legacy/synchronization/ and go through the steps of porting this from old kernel to the new one.
To make it more visual include snippets of the code in the documentation referencing the source code in the tree.

@zephyrbot
Copy link
Collaborator Author

by Anas Nashif:

will do a first pass on this, just to get us going and to have something online.

@zephyrbot
Copy link
Collaborator Author

by Mark Linkmeyer:

Correcting the priority field

@zephyrbot
Copy link
Collaborator Author

by David Kinder:

Is this https://www.zephyrproject.org/doc/porting/application.html "Work in Progress" document complete enough?

@zephyrbot zephyrbot added priority: medium Medium impact/importance bug area: Documentation Enhancement Changes/Updates/Additions to existing features labels Sep 23, 2017
@zephyrbot zephyrbot added this to the v1.7.0 milestone Sep 23, 2017
@zephyrbot zephyrbot mentioned this issue Sep 23, 2017
49 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area: Documentation Enhancement Changes/Updates/Additions to existing features priority: medium Medium impact/importance bug
Projects
None yet
Development

No branches or pull requests

2 participants